Get startedCLIAPIMCPWebDesktopAgentsSupportBillingChangelog
CLI · Reference

Configuration

Where the CLI reads settings from, environment variables that override them, output formats, and how to opt out of telemetry.

Config file

~/.dock/config.json

File mode 0600 (owner read/write only). Tracks signed-in accounts + defaults. Don't commit this file.

{
  "default": "vector-build",
  "format": "table",
  "telemetry": true,
  "accounts": {
    "vector-build": { "user": "you@vector.build", ... }
  }
}

Environment variables

VarDescription
DOCK_API_KEYBearer token. Overrides the OAuth token in the config file. Use for headless / CI / agent contexts.
DOCK_ORGForce operations to a specific org slug regardless of the config-file default. Useful for scripts that should be unambiguous.
DOCK_BASE_URLDefaults to https://trydock.ai. Override for staging or local dev.
DOCK_FORMATDefault output format: table · json · csv · markdown. Overrides the config file. Per-command --format flag overrides this.
DOCK_NO_TELEMETRYSet to any non-empty value to opt out of anonymous usage telemetry. See below.
NO_COLORSet to disable colored output. Standard cross-tool env var.

Output formats

  • table (default): ASCII table for human reading. Auto-truncates wide columns.
  • json: machine- readable. Pipe into jq for further processing.
  • csv: spreadsheet- ready. Includes a header row.
  • markdown: GitHub-flavored markdown table. Useful for piping into email or chat.

Telemetry

The CLI sends anonymous usage data on each invocation:

  • Command name (e.g. workspaces.list)
  • Exit code (0 / non-0)
  • Duration (ms bucket)
  • CLI version + Node version + OS

We do NOT send: command arguments, workspace names, row contents, your email, your IP, or anything else identifying. Source: telemetry.ts.

Opt out: DOCK_NO_TELEMETRY=1 or dock telemetry off.