@pilots/cli

CLI for managing pilots — secure, persistent, hardware-isolated Linux microVMs built for AI agents. Boot in milliseconds, checkpoint instantly, restore on demand, scale to thousands.

Learn more at pilots.run.

Install

npm install -g @pilots/cli

Or run without installing:

npx @pilots/cli login

Requires Node.js 18+.

Quick start

pilot login                      # authenticate via device flow
pilot create mybox               # spin up a pilot
pilot console mybox              # open an interactive shell
pilot exec mybox -- ls /         # run a one-shot command
pilot url mybox                  # get the pilot's public URL
pilot list                       # list your pilots
pilot destroy mybox              # tear it down

Authentication

Interactive (recommended):

pilot login

Opens a verification URL — enter the code on the dashboard, the CLI picks up the token automatically.

Direct token (CI/CD):

pilot auth setup --token <token>

Tokens are created at https://app.pilots.run/dashboard/tokens.

Credentials are stored in ~/.config/pilot/config.json.

Commands

| Command | What it does | |---|---| | pilot login | Device-flow authentication | | pilot auth setup --token <t> | Set token directly (CI/CD) | | pilot auth status | Show current auth status | | pilot auth logout | Clear stored credentials | | pilot create <name> [opts] | Create a pilot (--location, --size, --storage, --port, --hibernate-after) | | pilot list | List your pilots with state | | pilot console <name> | Interactive terminal session (auto-wakes if hibernated) | | pilot exec <name> <cmd...> | Run a one-shot command (auto-wakes) | | pilot hibernate <name> | Manually hibernate | | pilot wake <name> | Manually wake | | pilot url <name> [--auth public\|private] | Get URL / set auth mode | | pilot checkpoint create <name> [--comment] | Create a filesystem checkpoint | | pilot checkpoint list <name> | List checkpoints | | pilot checkpoint restore <name> <id> | Restore a checkpoint | | pilot destroy <name> | Destroy a pilot |

Configuration

| Setting | Where | Default | |---|---|---| | API token | ~/.config/pilot/config.json (apiToken) | — | | API URL | PILOT_API_URL env or apiUrl in config | https://app.pilots.run |

License

MIT — see LICENSE.