D1VD1V

d1v CLI

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

Install and verify

Recommended installer:

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

Alternative package managers:

brew install d1v-ai/tap/d1v
# or
cargo binstall d1v-cli

Authenticate

d1v auth login
d1v project list
d1v github status

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

Start a local runtime

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

d1v runtime doctor
d1v agent pair
d1v agent start

Bind an existing directory to a project:

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.

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.

Upgrade and remove

d1v upgrade
d1v uninstall

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