Namespace Command Line Tools - Namespace Documentation

Namespace has two command line tools. nsc drives the Namespace platform, and devbox drives Devboxes. They are installed separately, and each one authenticates against your workspace on its own.

Namespace CLI

Install nsc and run the platform from your terminal.

Devbox CLI

Install devbox to create and work in Devboxes.

Get started

Namespace CLI
Devbox CLI

curl -fsSL https://get.namespace.so/cloud/install.sh | sh
nsc login

# Start an ephemeral instance, then open a shell in it
nsc create
nsc ssh <instance-id>

See Installation for Homebrew, npm, Hermit, and Windows.

curl -fsSL get.namespace.so/devbox/install.sh | bash
devbox login

# Create a Devbox, then open a shell in it
devbox create --name my-devbox
devbox ssh my-devbox

See Installation for macOS, Linux, and Windows.

Common tasks

Both tools cover the same shape of work on different resources.

Task	Namespace CLI	Devbox CLI
Log in	`nsc login`	`devbox login`
Create	`nsc create`	`devbox create`
List what is running	`nsc list`	`devbox list`
Open a shell	`nsc ssh`	`devbox ssh`
Run one command	`nsc run`	`devbox exec`
Tear down	`nsc destroy`	`devbox delete`

If you want to drive Namespace from code instead of a terminal, see the API and SDKs.

Namespace CLI

Devbox CLI

​Get started

​Common tasks

Get started

Common tasks