Skip to content

Sandbox

List sandboxes

Flags: --status, --type

Terminal window
retask sandbox list --type PRIVATE

Get a sandbox by ID

Terminal window
retask sandbox get <sandbox-id>

Create a sandbox. –sharing sets who can use it (WORKSPACE_EDIT, WORKSPACE_VIEW, PRIVATE; default PRIVATE) — agents can only run on a WORKSPACE_* sandbox. Custom config via –env/–git-repo/–startup-command/–session-init-command/–shutdown-policy/–integration-provider-id, all mutually exclusive with –template-id

Flags: --name, --type, --sharing, --template-id, --env, --git-repo, --startup-command, --session-init-command, --shutdown-policy, --integration-provider-id

Terminal window
retask sandbox create --name my-sandbox --session-init-command 'claude --dangerously-skip-permissions "$SEED_PROMPT"'

Update a sandbox. –sharing changes who can use it: WORKSPACE_EDIT, WORKSPACE_VIEW, PRIVATE

Flags: --name, --sharing

Terminal window
retask sandbox update <id> --sharing WORKSPACE_EDIT

Stop a running sandbox

Terminal window
retask sandbox stop <sandbox-id>

Delete a sandbox

Terminal window
retask sandbox delete <sandbox-id>

List sessions

Flags: --sandbox-id, --status

Terminal window
retask sandbox session list --sandbox-id <sb-id>

Get a session by ID

Terminal window
retask sandbox session get <session-id>

Create a sandbox session

Flags: --sandbox-id, --name

Terminal window
retask sandbox session create --sandbox-id <sb-id>

Partial update a session

Flags: --name, --seed-nrn, --seed-prompt

Terminal window
retask sandbox session update <id> --name "My Session"

Stop a session

Terminal window
retask sandbox session stop <session-id>

Delete a session

Terminal window
retask sandbox session delete <session-id>

Connect this machine as a Private VM sandbox (long-running). Logs go to the TUI (stderr when headless) and to retask.log in the current folder, which rotates into retask.log.1 … retask.log.N

Flags: --mode, --auto-open, --no-auto-respond, --session-buffer, --log-file, --no-log-file, --log-max-size, --log-backups, --no-log-path

Terminal window
retask sandbox connect <sandbox-id>

Attach terminal to a running local session

Terminal window
retask sandbox attach <session-id>