Sandbox Tools
Tools for managing sandbox lifecycle: list, inspect, start, stop, restart, kill, and read logs.
Tools
| Tool | Description |
|---|---|
list_sandboxes | Return a summary list of all known sandboxes |
inspect_sandbox | Detailed sandbox info: ports, block name, status, uptime |
start_sandbox | Start a stopped sandbox |
stop_sandbox | Gracefully stop a running sandbox |
restart_sandbox | Stop then start a sandbox |
kill_sandbox | Force-kill a sandbox (SIGKILL) |
get_sandbox_logs | Tail stdout or stderr log lines |
Sandbox IDs
All tools that target a specific sandbox require a sandbox_id. Obtain IDs from
list_sandboxes. IDs are stable across restarts for the same project/block
combination — they are derived from the stack name and block name.
Log Retrieval
get_sandbox_logs returns the last N lines of stdout or stderr (default: 20).
Output is truncated at max_output_bytes (default: 64 KB). For large log
files, prefer search_sandbox_logs which uses FTS5 to return only relevant
lines.