CLI · Reference

Examples

Common scripted workflows. Each example is self-contained and copy-paste ready (assuming you've installed the CLI and signed in).

Bulk import a CSV

Pipe a CSV through the CLI to add every row to a workspace:

dock rows import launch-plan ./tasks.csv
# → 142 rows imported into launch-plan in 1.8s

First row is treated as the header. Column names match existing column labels case-insensitively. Missing columns are auto-created as text.

Periodic report (cron)

Email yourself a daily list of incomplete tasks:

#!/bin/bash
# /usr/local/bin/morning-tasks.sh — run via cron at 8am

dock rows list launch-plan \
  --filter 'status != "Done"' \
  --format markdown \
  | mail -s "Today's launch tasks" you@vector.build

Fan out work to an agent fleet

For each row needing work, dispatch an agent via your orchestrator:

dock rows list content-pipeline \
  --filter 'status = "Queued"' \
  --format json \
  | jq -c '.[]' \
  | while read row; do
      url=$(echo $row | jq -r '.fields.url')
      curl -X POST https://your-orchestrator/work \
        -H "Content-Type: application/json" \
        -d "{\"url\": \"$url\", \"row_id\": \"$(echo $row | jq -r '.id')\"}"
    done

CI / CD integration

After a deploy, log the deploy as a row in a tracking workspace:

# .github/workflows/post-deploy.yml
- name: Log deploy to Dock
  env:
    DOCK_API_KEY: ${{ secrets.DOCK_API_KEY }}
  run: |
    npx @trydock/cli rows add deploys \
      --field "Service=$\{{ github.event.repository.name }}" \
      --field "Sha=$\{{ github.sha }}" \
      --field "Actor=$\{{ github.actor }}" \
      --field "Status=success"

Watch a workspace live

dock rows watch launch-plan
# → connects to the SSE stream, prints every row event:
# 14:32:01 Argus updated row r_01J... · status: Done
# 14:32:14 you      added row r_01K... · "Newsletter draft"
# 14:32:55 Scout   commented on r_01J... · "Looks good to ship"

Export everything

# Single workspace
dock workspaces export launch-plan > launch-plan.json

# Whole org
dock me export > dock-export.json

Commands — full reference for every command + flag.
Configuration — env vars, output formats, telemetry.