Commands on claustro

claustro init

Mon, 01 Jan 0001 00:00:00 +0000

claustro init#

Initialize a new claustro project with an interactive setup wizard.

Usage#

claustro init [flags]

Flags#

Flag	Description	Default
`--project`	Project name	directory basename
`--languages`	Comma-separated: go,rust,python	all enabled
`--tools`	Comma-separated: dev,build	all enabled
`--mcp`	Comma-separated: filesystem,memory,fetch	all enabled
`--cpus`	CPU limit	4
`--memory`	Memory limit	8G
`--firewall`	Enable egress firewall	false
`--readonly`	Mount source read-only	false
`-y, --yes`	Accept all defaults	false

Examples#

claustro init
claustro init -y
claustro init --languages go,python --cpus 8 --memory 16G

claustro up

Mon, 01 Jan 0001 00:00:00 +0000

claustro up#

Create and start a sandbox container.

Usage#

claustro up [flags]

Flags#

Flag	Description	Default
`--name`	Sandbox name	auto-generated
`--workdir`	Working directory	project root
`--mount`	Additional bind mount (repeatable)	none
`--env`	Environment variable KEY=VALUE (repeatable)	none
`--readonly`	Mount source read-only	false
`--firewall`	Enable egress firewall	false
`--isolated-state`	Use Docker volume for ~/.claude	false

Examples#

claustro up
claustro up --name api --workdir ./services/api
claustro up --mount ./libs:/workspace/libs:ro --firewall

claustro burn

Mon, 01 Jan 0001 00:00:00 +0000

claustro burn#

Stop and remove a sandbox container. Preserves the image and cache volumes.

Usage#

claustro burn [name] [flags]

Flags#

Flag	Description
`--name`	Sandbox name
`--all`	Burn all sandboxes for the current project

claustro shell

Mon, 01 Jan 0001 00:00:00 +0000

claustro shell#

Open an interactive shell (zsh) inside a running sandbox.

Usage#

claustro shell [name] [flags]

Flags#

Flag	Description
`--name`	Sandbox name

claustro claude

Mon, 01 Jan 0001 00:00:00 +0000

claustro claude#

Launch Claude Code inside a sandbox. Automatically starts a sandbox if none is running.

Usage#

claustro claude [name] [flags] [-- claude-args...]

Flags#

Flag	Description
`--name`	Sandbox name

Examples#

claustro claude
claustro claude api
claustro claude -- --model opus

claustro config

Mon, 01 Jan 0001 00:00:00 +0000

claustro config#

View and modify claustro configuration.

Interactive Subcommands#

claustro config languages # Configure image languages
claustro config tools # Configure tool groups
claustro config mcp # Configure MCP servers
claustro config defaults # Configure resource defaults
claustro config firewall # Configure firewall settings
claustro config git # Configure git integration

Get/Set#

claustro config get <path>
claustro config set <path> <value>

Examples#

claustro config get image.languages.go
claustro config set defaults.resources.cpus 8
claustro config set image.languages.rust true

claustro validate

Mon, 01 Jan 0001 00:00:00 +0000

claustro validate#

Validate the claustro.yaml configuration file.

Usage#

claustro validate

Exit Codes#

Code	Meaning
0	Valid (warnings OK)
1	Errors found

claustro doctor

Mon, 01 Jan 0001 00:00:00 +0000

claustro doctor#

Check host environment health. Validates Docker, git, SSH, clipboard, and configuration.

Usage#

claustro doctor

claustro exec

Mon, 01 Jan 0001 00:00:00 +0000

claustro exec#

Run a command inside a running sandbox.

Usage#

claustro exec [name] -- <command> [args...]

Flags#

Flag	Description
`--name`	Sandbox name

Examples#

claustro exec -- go test ./...
claustro exec api -- npm run build

claustro ls

Mon, 01 Jan 0001 00:00:00 +0000

claustro ls#

List sandboxes for the current project.

Usage#

claustro ls [flags]

Flags#

Flag	Description
`--all`	List sandboxes across all projects

claustro nuke

Mon, 01 Jan 0001 00:00:00 +0000

claustro nuke#

Remove a sandbox and its cache volumes. Preserves the image.

Usage#

claustro nuke [name] [flags]

Flags#

Flag	Description
`--all`	Nuke all sandboxes for the current project

claustro rebuild

Mon, 01 Jan 0001 00:00:00 +0000

claustro rebuild#

Rebuild the Docker image from scratch.

Usage#

claustro rebuild [flags]

Flags#

Flag	Description	Default
`--restart`	Restart running sandboxes after rebuild	false

claustro status

Mon, 01 Jan 0001 00:00:00 +0000

claustro status#

Show sandbox details including state, uptime, resource usage, and mounted paths.

Usage#

claustro status [name] [flags]

Flags#

Flag	Description
`--name`	Sandbox name

claustro logs

Mon, 01 Jan 0001 00:00:00 +0000

claustro logs#

Display container logs.

Usage#

claustro logs [name] [flags]

Flags#

Flag	Description	Default
`--name`	Sandbox name
`-f, --follow`	Follow log output	false
`--tail`	Number of lines to show	100