Beta

Donum CLI

Latest · v2.1.0

Your workspace.
One command away.

The Donum CLI brings reports, governed data, workflows, agents, and operations into the terminal without creating a second control plane.

donum · workspace terminal ready

$donum auth login

browser approval complete · workspace selected

$donum reports generate 6280dcd7 --stream

report generated · changes persisted

$donum doctor

API · PostgreSQL/pgvector · Redis · Intelligence

all configured services healthy

$npm install -g @donumhq/cli@latest

Node.js 22.12 or newer

Browser-based device authorization

Human and JSON output modes

Built for real operations

From first report
to production health.

Create · generate · export

Reports

Create, generate, open, import, export, and safely remove workspace reports.

Datasets · metrics · lineage

Governed data

Upload CSV data, inspect dataset lineage, promote tiers, evaluate metrics, and manage watches.

Run · pause · logs

Workflows

List and trigger workflows, control schedules, and inspect or follow their run history.

Run · review · apply

Agents

Create agents from natural language, run them, review proposals, and apply approved work.

Search · extract

Knowledge and brand

Upload and search workspace knowledge, inspect Brand DNA, and run brand extraction.

Doctor · Azure · API

Operations

Check service health, inspect configured Azure resources and logs, or call authorized API routes directly.

Start clean

From zero to useful.
Without ceremony.

01

Install from npm

Install the published @donumhq/cli package globally. The page reads the latest published version directly from npm.

npm install -g @donumhq/cli@latest
02

Approve this device

Run the login command. Donum opens a browser approval flow and stores the resulting device session in the operating system keyring.

donum auth login
03

Choose the workspace and act

The active workspace is explicit and switchable. Commands continue to respect the role and permissions attached to your account.

donum workspaces list

Power,
properly bounded.

No password in the terminal

Device authorization moves sign-in and approval into the browser instead of collecting credentials in the CLI.

Secrets stay out of config output

Session tokens use the operating system keyring, and configuration output does not print them.

Safe automation primitives

Machine-readable JSON, bounded timeouts, validation, and stable exit codes make commands suitable for scripts and agents.

Production visibility

Doctor and Azure commands inspect the API, intelligence service, pgvector, Redis, resource health, and configured logs.

Release channel

Version 2.1.0 is current.

Use donum --version to confirm the build installed on your machine.

View CLI release notes