CLI reference
Use devbox --help from your installed release for its complete command syntax. Commands below cover the current BYO workflow; angle-bracket values must be replaced.
Connections
devbox connection add home --ssh my-box
devbox connection add home --ssh vpn-box --route vpn
devbox connection list --json
devbox connection remove home --route vpnRepository and tools
Run setup/open from your local repository. Omit --computer only when one configured computer is unambiguous.
devbox setup --computer home
devbox setup --computer home --include-working-tree
devbox setup --computer home --remote-dir '~/src/payments' --existing reuse
devbox setup --computer home --remote-dir '~/src/payments' --existing update
devbox setup --computer home --remote-dir '~/src/payments' --existing merge
devbox setup --computer home --remote-dir '~/src/payments' --existing replace
devbox open --computer home --with code
devbox open --computer home --workspace <id> --with codexTool values: shell, code, cursor, claude, codex, claude-desktop, codex-desktop, paseo, t3. Tool-specific behavior is described in editors and agents.
--remote-dir accepts an absolute host path or quoted ~/…; it is mutually exclusive with --workspace. --existing is setup-only. If host process visibility is incomplete, mutation refuses until you stop tools and explicitly acknowledge that with --confirm-stopped; it never overrides detected activity. Review the reconciliation and recovery rules before update, merge or replacement.
Inventory
devbox workspace list --computer home
devbox workspace list --computer home --json
devbox workspace refresh --computer home
devbox workspace enter <id> --computer home
devbox services --computer homeCurrent host helpers are required for complete native inventory. Cached and incomplete observations are labelled; explicit selection may be needed.
Private preview
devbox preview --computer home
devbox preview 3000 --computer home --local-port 43000Hosted account and host enrollment
devbox login --computer <computer-id>
devbox up my-box --manifest-url <https-manifest> --public-key <file>
devbox browser
devbox doctorThese need the corresponding operator-enabled hosted capability. They do not create a managed VM implicitly. --allow-private-file is an explicit credential-storage fallback where supported.
Environment
| Variable | Purpose |
|---|---|
FIVE08_REMOTE_API_URL | HTTPS control-plane origin; installer launcher supplies its default |
FIVE08_REMOTE_RELEASE_MANIFEST_URL | Operator-signed daemon release manifest |
FIVE08_REMOTE_RELEASE_PUBLIC_KEY_FILE | Independently trusted daemon verification key file |
XDG_CONFIG_HOME | Local saved connection/credential configuration root |
XDG_DATA_HOME | Client installation data root |
Avoid passing secrets as command-line arguments or writing them into shell history. Use supported private files/keyring storage instead.