CLI Reference

Complete command reference for the csb command-line interface.

Global Options

These options are available for all commands:

--help, -h       Show help for a command
--version, -v    Show the CLI version
--json           Output in JSON format
--quiet, -q      Suppress non-essential output
--verbose        Enable verbose logging

csb create

Create a new sandbox.

bash

csb create --agent <agent> --name <name> [options]

Options:

--agent — AI agent type (claude, codex, copilot, gemini, kiro, opencode, cagent)
--name — Sandbox name (must be unique)
--port — Port mapping (host:container)
--env — Environment variable (KEY=value, repeatable)
--tunnel — Enable tunnel access on creation
--template — Use a community template

csb list

List all sandboxes.

bash

csb list [--stats] [--filter <status>]

Options:

--stats — Include CPU, memory, and network usage
--filter — Filter by status (running, stopped, all)

csb start

Start a stopped sandbox.

bash

csb start <name>

csb stop

Stop a running sandbox.

bash

csb stop <name> [--force]

csb delete

Delete a sandbox and all its data.

bash

csb delete <name> [--force]

csb info

Show detailed information about a sandbox.

bash

csb info <name>

csb logs

View container logs for a sandbox.

bash

csb logs <name> [--follow] [--tail <n>]

csb tunnel

Manage tunnel access for a sandbox.

bash

csb tunnel enable <name>
csb tunnel disable <name>
csb tunnel info <name>
csb tunnel list

csb snapshot

Manage sandbox snapshots.

bash

csb snapshot create <name> --name <snapshot-name>
csb snapshot list <name>
csb snapshot restore <name> --name <snapshot-name>
csb snapshot delete <name> --name <snapshot-name>

csb update

Check for and install updates.

bash

csb update [--check]

Local API

MCP Server