D1VD1V
D1V Docs / CLI / 5 sections

d1v CLI

Install the CLI, authenticate this machine, and optionally attach a local runtime to a project.

01

Install and verify

Recommended installer:

bash
curl -fsSL https://d1v.ai/install/d1v-cli.sh | bash
d1v --help

Alternative package managers:

bash
brew install d1vai/tap/d1v
# or
cargo binstall d1v-cli
02

Authenticate

bash
d1v auth login
d1v project list
d1v github status

Use --format json for scripts. Use --lang and --color when terminal defaults are not appropriate.

03

Start a local runtime

Inspect the runtime, pair the device, then start the agent:

bash
d1v runtime doctor
d1v agent pair
d1v agent start

Bind an existing directory to a project:

bash
d1v agent project bind --project-id <project_id> --path ~/work/my-app

The local agent creates an outbound connection to d1v. No inbound port on the machine is required for normal runtime control.

04

Automation and environment variables

  • D1V_API_KEY: API-key authentication for automation
  • D1V_AUTH_TOKEN: existing authentication token
  • D1V_BASE_URL: alternate control-plane base URL
  • D1V_FORMAT: default output format
  • D1V_LOG_FILE: diagnostic log destination

Do not commit tokens or API keys. Prefer a secret manager in CI.

05

Upgrade and remove

bash
d1v upgrade
d1v uninstall

Run d1v runtime doctor again after an upgrade when local runtime behavior changes unexpectedly.