# boxes.dev CLI

`dvb` is the command-line interface for [boxes.dev](https://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:

```bash
npm install -g @boxes-dev/cli
```

You can also install the same build without npm:

```bash
curl -fsSL https://deploy.boxes.dev/cli/install.sh | sh
```

## Get started

Sign in and connect your coding agents:

```bash
dvb setup
```

If you don't have a project yet, set one up with the
[desktop app](https://boxes.dev) or
[with your local coding agent](https://boxes.dev/help/local-agent-setup).

## 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.

## Learn more

- [Use the CLI](https://boxes.dev/help/use-cli)
- [How boxes.dev works](https://boxes.dev/help/how-boxes-works)
- [Support](https://boxes.dev/support)
