Add per-command environment and working directory options

Document new env and cwd parameters for exec(), execStream(), and
startProcess() methods. These options allow temporary per-command
overrides of session/sandbox-level settings without persisting changes.

- Updated commands.mdx with env and cwd parameters for exec() and execStream()
- Added example showing usage of env and cwd options
- Updated startProcess() documentation with complete options list
- Updated environment-variables.mdx to include execStream() example

Related PR: cloudflare/sandbox-sdk#204

Generated with Claude Code

Co-Authored-By: Claude <[email protected]>

Author: github-actions[bot]

src/content/docs/sandbox/api/commands.mdx

@@ -25,6 +25,8 @@ const result = await sandbox.exec(command: string, options?: ExecOptions): Promi
   - `stream` - Enable streaming callbacks (default: `false`)
   - `onOutput` - Callback for real-time output: `(stream: 'stdout' | 'stderr', data: string) => void`
   - `timeout` - Maximum execution time in milliseconds
+  - `env` - Environment variables for this command (temporarily override session/sandbox-level variables)
+  - `cwd` - Working directory for this command execution
 
 **Returns**: `Promise<ExecuteResponse>` with `success`, `stdout`, `stderr`, `exitCode`
 
@@ -38,6 +40,12 @@ if (result.success) {
   console.error('Build failed:', result.stderr);
 }
 
+// With custom environment and working directory
+await sandbox.exec('node app.js', {
+  env: { NODE_ENV: 'production', PORT: '3000' },
+  cwd: '/workspace/my-app'
+});
+
 // With streaming
 await sandbox.exec('npm install', {
   stream: true,
@@ -56,7 +64,10 @@ const stream = await sandbox.execStream(command: string, options?: ExecOptions):
 
 **Parameters**:
 - `command` - The command to execute
-- `options` - Same as `exec()`
+- `options` (optional):
+  - `timeout` - Maximum execution time in milliseconds
+  - `env` - Environment variables for this command (temporarily override session/sandbox-level variables)
+  - `cwd` - Working directory for this command execution
 
 **Returns**: `Promise<ReadableStream>` emitting `ExecEvent` objects (`start`, `stdout`, `stderr`, `complete`, `error`)
 
@@ -93,8 +104,12 @@ const process = await sandbox.startProcess(command: string, options?: ProcessOpt
 **Parameters**:
 - `command` - The command to start as a background process
 - `options` (optional):
-  - `cwd` - Working directory
-  - `env` - Environment variables
+  - `env` - Environment variables for this process (temporarily override session/sandbox-level variables)
+  - `cwd` - Working directory for this process
+  - `timeout` - Maximum execution time in milliseconds
+  - `processId` - Custom process ID (auto-generated if not provided)
+  - `encoding` - Output encoding (default: `'utf8'`)
+  - `autoCleanup` - Automatically clean up process resources when done
 
 **Returns**: `Promise<ProcessInfo>` with `id`, `pid`, `command`, `status`
 

src/content/docs/sandbox/configuration/environment-variables.mdx

@@ -42,6 +42,13 @@ await sandbox.exec("node app.js", {
 	},
 });
 
+// Also works with execStream()
+await sandbox.execStream("python analyze.py", {
+	env: {
+		OPENAI_API_KEY: env.OPENAI_API_KEY,
+	},
+});
+
 // Also works with startProcess()
 await sandbox.startProcess("python server.py", {
 	env: {