Skip to content

CLI overview

Run cspace --help for the same listing in your terminal.

CommandPurpose
cspace up [<name>]Boot a sandbox. No name = auto-pick from planet list.
cspace down <name>Stop and remove a sandbox.
cspace down --allTear down every sandbox in the current project.
cspace attach <name>Open an interactive claude session inside a running sandbox.
cspace send <name> "<text>"Inject a turn into the supervisor’s session (non-interactive).
cspace ports <name>List ports the sandbox is listening on, with friendly URLs.
CommandPurpose
cspace doctorAggregate health check across all subsystems.
cspace registry listShow all registered sandboxes (any project).
cspace registry pruneRemove stale registry entries.
cspace versionPrint the installed version.
CommandPurpose
cspace image buildBuild the local sandbox image (one-time per host until image distribution lands).
cspace dns installWrite /etc/resolver/cspace2.local (sudo).
cspace dns uninstallRemove the resolver routing.
cspace dns statusVerify DNS routing end-to-end.
cspace daemon serveRun the registry HTTP + DNS daemon (auto-spawned by cspace up).
cspace daemon statusIs the daemon running?
cspace daemon stopStop the daemon (rarely needed).
CommandPurpose
cspace keychain initWalk through storing API keys in macOS Keychain.
cspace keychain statusShow where each credential is currently sourced from.
CommandPurpose
cspace self-updateUpdate the cspace binary in place.
cspace completion <shell>Generate shell completions.
Terminal window
cspace <command> --help

For example:

Terminal window
cspace up --help # all flags including --cpus, --memory, --no-browser, --no-attach
cspace registry --help # list / prune