Install the CLI

The devboxes command can start tasks, read session results, and run a connected machine. Installing the CLI alone does not start containers or connect a model account.

Install with pnpm

pnpm add --global devboxes
devboxes --version

The version command confirms that your shell can find the installation. Use devboxes --help to see its commands.

Use a native binary

Native downloads are published in the Devboxes CLI releases. Choose the file for your operating system and architecture. Check it against the release's SHA256SUMS before running it.

The native installer supports macOS and glibc-based Linux. Windows uses the PowerShell installer. A native musl Linux binary is not provided by the installer.

Download the native installer before running it:

curl --fail --location https://devboxes.ai/install -o devboxes-install

On macOS, verify the download with:

echo "35f4c98f35cbb7b1e1773ea523acccf0e4c5472d297195e0fe01dd965910ba32  devboxes-install" | shasum -a 256 --check

On Linux, use sha256sum --check in place of shasum -a 256 --check. Continue only if the check reports devboxes-install: OK:

sh devboxes-install

Sign in or connect a runner

To use task commands, sign in:

devboxes login

To execute tasks on this machine, Docker must be running. Continue with:

devboxes connect
devboxes credentials setup
devboxes doctor
devboxes listen

login authorizes the terminal. connect registers the execution machine. listen starts accepting tasks; it is not required when you only dispatch work to another runner.

See the first-task guide for repository and project setup, or the CLI guide for task commands.