Sandbox
Start sandbox sessions and run commands in an isolated execution environment from the CLI.
On this page6
The sandbox family manages sandbox sessions — isolated containers for running
arbitrary commands and shuffling files, separate from workflow execution. This is
the same sandbox substrate the AI agent uses for its shell tool.
Command summary
| Subcommand | Description |
|---|---|
sandbox start | Start a new sandbox session |
sandbox status | Show the current session's status |
sandbox exec <command> | Run a command in the sandbox |
sandbox logs | Show session logs |
sandbox files | Manage files in the sandbox |
sandbox stop | Stop the current session |
Lifecycle
trickest sandbox start # provision a session
trickest sandbox status # confirm it's ready
trickest sandbox exec "uname -a"
trickest sandbox stop # tear it down when donesandbox exec
Run a command inside the session:
trickest sandbox exec "ls -la /trickest/sandbox"
trickest sandbox exec "python3 script.py" --timeout 120000| Flag | Description |
|---|---|
--timeout <ms> | Command timeout in milliseconds (default 30000) |
sandbox logs
trickest sandbox logs
trickest sandbox logs --follow # poll and stream new log outputsandbox files
Move files in and out of the session:
| Subcommand | Description |
|---|---|
sandbox files ls [path] | List files in the sandbox |
sandbox files push <local> <remote> | Upload a local file |
trickest sandbox files ls /trickest/sandbox
trickest sandbox files push ./payload.txt /trickest/sandbox/payload.txt