Skip to content
d_devboxby 508.dev/ DocumentationDashboard ↗
Browse documentation
DOCUMENTATION / CLI reference

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

TERMINAL
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 vpn

Repository and tools

Run setup/open from your local repository. Omit --computer only when one configured computer is unambiguous.

TERMINAL
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 codex

Tool 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

TERMINAL
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 home

Current host helpers are required for complete native inventory. Cached and incomplete observations are labelled; explicit selection may be needed.

Private preview

TERMINAL
devbox preview --computer home
devbox preview 3000 --computer home --local-port 43000

Hosted account and host enrollment

TERMINAL
devbox login --computer <computer-id>
devbox up my-box --manifest-url <https-manifest> --public-key <file>
devbox browser
devbox doctor

These 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

VariablePurpose
FIVE08_REMOTE_API_URLHTTPS control-plane origin; installer launcher supplies its default
FIVE08_REMOTE_RELEASE_MANIFEST_URLOperator-signed daemon release manifest
FIVE08_REMOTE_RELEASE_PUBLIC_KEY_FILEIndependently trusted daemon verification key file
XDG_CONFIG_HOMELocal saved connection/credential configuration root
XDG_DATA_HOMEClient installation data root

Avoid passing secrets as command-line arguments or writing them into shell history. Use supported private files/keyring storage instead.

Development machines. Your code. Your control.
Private pilot · Feature availability is called out in each guide.