---
url: >-
  https://adk.nht.io/api/@nhtio/adk/batteries/sandbox/interfaces/RunShellCommandOptions.md
description: Configuration for the streaming shell-command tool.
---

# Interface: RunShellCommandOptions

Defined in: [src/batteries/sandbox/tool.ts:15](https://github.com/NHTIO/ADK/blob/v1.20260824.1/src/src/batteries/sandbox/tool.ts#L15)

Configuration for the streaming shell-command tool.

## Properties

| Property                                                 | Modifier   | Type                                                                                                                                                                                                            | Description                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                               | Defined in                                                                                                                |
| -------------------------------------------------------- | ---------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------- |
|  `allowedCommands?` | `readonly` | readonly `string`\[]                                                                                                                                                                                             | Optional command-name allow-list.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                         | [src/batteries/sandbox/tool.ts:25](https://github.com/NHTIO/ADK/blob/v1.20260824.1/src/src/batteries/sandbox/tool.ts#L25) |
|  `description?`         | `readonly` | `string`                                                                                                                                                                                                        | Optional tool description override.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                       | [src/batteries/sandbox/tool.ts:40](https://github.com/NHTIO/ADK/blob/v1.20260824.1/src/src/batteries/sandbox/tool.ts#L40) |
|  `env?`                         | `readonly` | [`Readonly`](https://www.typescriptlang.org/docs/handbook/utility-types.html#readonlytype)<[`Record`](https://www.typescriptlang.org/docs/handbook/utility-types.html#recordkeys-type)<`string`, `string`>> | Environment variables to add to every command this tool spawns. **Remarks** ADDITIVE, and applied LAST — over both the host variables the enforcer allow-listed and SRT's own proxy/CA plumbing. It is not the host-inheritance control: the enforcer decides what the child inherits (`envAllowList` / `inheritHostEnv` on the Node adapter), and this cannot re-admit a variable the enforcer withheld except by supplying the value literally here. Anything put here is readable by the model — `run_shell_command` runs commands the model chose, and `env` is one of them — so pass configuration, not credentials. | [src/batteries/sandbox/tool.ts:38](https://github.com/NHTIO/ADK/blob/v1.20260824.1/src/src/batteries/sandbox/tool.ts#L38) |
|  `gate?`                       | `readonly` | [`ToolGateFn`](../../tools/_shared/type-aliases/ToolGateFn.md)                                                                                                                                                  | Required human/policy approval gate.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                      | [src/batteries/sandbox/tool.ts:23](https://github.com/NHTIO/ADK/blob/v1.20260824.1/src/src/batteries/sandbox/tool.ts#L23) |
|  `narrate?`                 | `readonly` | [`SandboxNarrator`](../type-aliases/SandboxNarrator.md)                                                                                                                                                         | Injectable model-facing outcome renderer.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                 | [src/batteries/sandbox/tool.ts:42](https://github.com/NHTIO/ADK/blob/v1.20260824.1/src/src/batteries/sandbox/tool.ts#L42) |
|  `policy`                    | `readonly` | [`SandboxPolicy`](SandboxPolicy.md)                                                                                                                                                                             | Policy applied to the spawned command.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                    | [src/batteries/sandbox/tool.ts:19](https://github.com/NHTIO/ADK/blob/v1.20260824.1/src/src/batteries/sandbox/tool.ts#L19) |
|  `sandbox`                  | `readonly` | [`SandboxPolicyEnforcer`](SandboxPolicyEnforcer.md)                                                                                                                                                             | Streaming policy enforcer; unlike BinaryExecutor this exposes live stdout/stderr.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                         | [src/batteries/sandbox/tool.ts:17](https://github.com/NHTIO/ADK/blob/v1.20260824.1/src/src/batteries/sandbox/tool.ts#L17) |
|  `translator`            | `readonly` | [`PathTranslator`](PathTranslator.md)                                                                                                                                                                           | Model-path translator for the working directory.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                          | [src/batteries/sandbox/tool.ts:21](https://github.com/NHTIO/ADK/blob/v1.20260824.1/src/src/batteries/sandbox/tool.ts#L21) |