LocalShellBackendOptions

Environment variables for shell commands. If undefined, starts with an empty environment (unless inheritEnv is true).

Whether to inherit the parent process's environment variables. When false, only variables in env dict are available. When true, inherits all process.env variables and applies env overrides.

Files to create on disk during create(). Keys are file paths (resolved via the backend's path handling), values are string content.

Maximum number of bytes to capture from command output. Output exceeding this limit will be truncated.

Working directory for both filesystem operations and shell commands. When set with virtualMode: false (default), absolute paths and .. can bypass rootDir for filesystem operations.

Maximum time in seconds to wait for shell command execution. Commands exceeding this timeout will be terminated.

Enable virtual path mode for filesystem operations. When true, treats rootDir as a virtual root filesystem. When false (default), preserves legacy path behavior. Does NOT restrict shell commands.