execute_command
Run a shell command on a devbox and block until completion. Reuse a named shell for stateful sessions that preserve environment and working directory.
Instructions
Execute a command on a devbox and block until it completes.
Each call spawns an isolated shell by default - env vars and CWD do not
persist between calls. Pass the same shell_name to reuse a stateful
named shell session.
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": {
"devbox_id": "<devbox_id>",
"command": "<command>"
},
"name": "execute_command"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| command | Yes | The shell command to run. | |
| devbox_id | Yes | The id of the devbox. | |
| shell_name | No | Optional named shell for stateful sessions (same name reconnects to the same live session). | |
| timeout_seconds | No | Maximum time to wait for completion (HTTP timeout). |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
No arguments | |||