exec_command
Runs allowlisted binaries such as pytest, ruff, git, or ls with static arguments, no shell expansion, a scrubbed environment, and a process-group timeout to safely execute workspace commands.
Instructions
Execute an allowlisted binary (e.g. pytest, ruff, mypy, git, ls) with shell=False, argument safety guards, scrubbed environment, and process-group timeout SIGKILL.
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"binary": "<binary>"
},
"name": "exec_command"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| cwd | No | Relative working directory inside the workspace root. | . |
| args | No | Static argument list passed directly to the binary without shell expansion. | |
| binary | Yes | Allowlisted binary name (e.g. 'pytest', 'ruff', 'git', 'ls') executed with shell=False. | |
| timeout_seconds | No | Optional execution timeout in seconds (clamped by policy max_timeout_seconds). |