Use Doozy from your terminal

The Doozy CLI is a terminal client for the same workspace you use in the app, over the same scoped API key.

Install

You need Node 20 or newer. On macOS or Linux:

curl -fsSL https://usedoozy.com/install-cli.sh | sh

The script downloads https://usedoozy.com/cli/0.1.0/doozy.js, verifies its SHA-256 checksum from the adjacent .sha256 file, and installs ~/.doozy/bin/doozy. Re-run it to upgrade. Verify the installed file with:

export PATH="$HOME/.doozy/bin:$PATH" # only needed until you open a new shell
doozy --version

Npm and pip packages: coming soon. The npm package remains private until package-manager distribution is ready.

Contributors can run it from source:

git clone https://github.com/dcouple/doozy.git
cd doozy
npm ci
npx nx build @doozy/cli
node apps/cli/bin/doozy.js --version

Get a key

Create a key under Settings > API keys, then export it. Authentication and keys covers scopes, rotation, and revocation.

export DOOZY_API_KEY="doozy_sk_..."

Prove it works

doozy me

workspace   Acme customer success  4f30d6f1-...
user        You <you@acme.com>
credential  api_key: Terminal
expires     never
scopes      todos:read, todos:write, chats:read
base url    https://api.usedoozy.com/api/v1

The workspace name must match the workspace where you created the key.

Day one commands

List active work:

doozy todos ls --status active

ID        PRI  STATUS       TITLE                  UPDATED
1b4c9d2e  high  ready        Review the Q3 numbers  3m ago
8ad15c40  none  in progress  Draft customer reply   1m ago
2 todos

Count it without printing every row:

doozy todos count

total 12
active 10
  ready       8
  in_progress 2
  done        2

Create a todo:

doozy todos create "Review the Q3 numbers" --priority high

created 1b4c9d2e-...  Review the Q3 numbers

Complete it:

doozy todos done 1b4c9d2e-...

done 1b4c9d2e-...  Review the Q3 numbers

List conversations with agents:

doozy chats ls --limit 5

ID        STATUS     TITLE                    MSGS     LAST
7ed091af  completed  Q3 review follow-up         4   2m ago

Use it from a script

Every create and agent run sends an idempotency key by default, so a retry after a timeout returns the first result instead of creating duplicate work. Use --json on any command for machine-readable output:

doozy todos ls --status active --json

Exit codes are stable: 0 success, 1 API or network failure, 2 invalid usage, and 3 missing or invalid local credentials.

Run doozy --help for the full command reference generated from the CLI’s own command table, or doozy help <command> for every option on one command.