boxes.dev CLI
dvb is the command-line interface for boxes.dev, which
gives every coding agent its own cloud computer. From a terminal on your
computer, you can start and continue Claude Code and Codex threads on your
devboxes, open a shell on a devbox, forward ports, and copy files.
Install
Install dvb on your own Mac or Linux computer. Don't install it on a
boxes.dev machine.
This package installs the standalone build of dvb, which includes its own
runtime:
npm install -g @boxes-dev/cli
You can also install the same build without npm:
curl -fsSL https://deploy.boxes.dev/cli/install.sh | sh
Get started
Sign in and connect your coding agents:
dvb setup
If you don't have a project yet, set one up with the desktop app or with your local coding agent.
Common commands
| Command | What it does |
|---|---|
dvb agents | Lists your threads so you can continue one or start a task. |
dvb codex / dvb claude | Starts a thread in the agent's own terminal interface. |
dvb list | Lists your Template boxes and devboxes. |
dvb connect <devbox> | Opens a shell on a devbox. |
dvb ports | Lists ports and manages port forwarding. |
dvb cp <local-path> <devbox>:<remote-path> | Copies a file or directory to a devbox. |
dvb report-bug "<description>" | Sends a bug report to the boxes.dev team. |
Run dvb --help or dvb <command> --help for every command and option.