Skip to main content
Start a long-running command in a sandbox as a background command. Returns command metadata immediately.

Tool details

FieldValue
Namestart_sandbox_background_command
GroupSandbox

Playground

Input schema

Input schema
{
  "type": "object",
  "properties": {
    "id": {
      "type": "string",
      "description": "Sandbox session ID returned by create_sandbox_session"
    },
    "command": {
      "type": "string",
      "description": "Shell command to execute"
    },
    "cwd": {
      "type": "string",
      "description": "Working directory for the command"
    },
    "timeout_seconds": {
      "type": "number",
      "description": "Timeout in seconds for the command"
    },
    "env": {
      "type": "object",
      "additionalProperties": {
        "type": "string",
        "description": "Additional structured values supplied to the tool."
      },
      "description": "Additional environment variables for the command"
    }
  },
  "required": [
    "id",
    "command"
  ],
  "additionalProperties": false,
  "description": "Input schema for the start_sandbox_background_command tool.",
  "$schema": "http://json-schema.org/draft-07/schema#"
}

Output schema

Output schema
{
  "type": "object",
  "properties": {
    "command_id": {
      "type": "string",
      "description": "The command id associated with this tool result."
    },
    "status": {
      "type": "string",
      "description": "Lifecycle status for the returned record."
    },
    "exit_code": {
      "anyOf": [
        {
          "type": "integer",
          "description": "The exit code associated with this tool result."
        },
        {
          "type": "null",
          "description": "The exit code returned by the tool."
        }
      ],
      "description": "The exit code associated with this tool result."
    }
  },
  "required": [
    "command_id",
    "status"
  ],
  "additionalProperties": true,
  "description": "Structured result returned by the start_sandbox_background_command tool.",
  "$schema": "http://json-schema.org/draft-07/schema#"
}