CLI reference
Entry point: daari (Typer).
Top-level
| Command |
Purpose |
serve |
Run the gateway daemon |
stats |
Tier counters (GET /v1/daari/stats JSON, including compact_to_fit_applied / compact_to_fit_tokens_dropped) |
doctor |
Health / suggest-models (--strict treats pending migrate as required) |
migrate |
Open durable stores / --dry-run inspect pending additive migrations |
install |
Convenience installer helpers |
onboard |
pip/brew first-run (Ollama + default models) |
feedback |
Record accept/reject |
trace |
Show a request trace (compact_to_fit steps include tokens_before / tokens_after when a trim ran) |
report |
Savings / usage ledger |
usage |
Alias of report |
spend |
Per-request chargeback export (export, --tier) and rollups (report, --by-tool, --by-user) — see chargeback |
profile |
Local hardware profile |
route |
Routing helpers (preview) |
audit |
Enterprise audit log (list / export / verify) |
alerts |
Webhook signing-secret rotation (rotate-secret) — dual-secret grace for budget / key-expiry |
configure |
Interactive config helpers |
config |
Validate config.yaml (validate) |
prune |
Retention prune (traces / usage / feedback) |
erase |
Subject erasure (--key / --team / --user, --dry-run / --yes) |
backup |
Full-state archive (create / restore) |
backup
| Command |
Purpose |
backup create PATH |
Snapshot durable stores to a .tar.gz |
backup create PATH --encrypt openssl\|age |
Encrypt after create (host openssl / age; no new Python crypto dep) |
backup create PATH --require-pg-dump |
Fail if Postgres-backed stores cannot be embedded via pg_dump |
backup restore PATH |
Restore archive (decrypts .enc / .age when credentials are set) |
backup restore PATH --restore-pg |
Also apply embedded stores/pg/*.sql dumps via psql |
Encryption env / flags: DAARI_BACKUP_PASS (or --passphrase-env),
DAARI_BACKUP_AGE_RECIPIENT / --age-recipient on create,
DAARI_BACKUP_AGE_IDENTITY / --age-identity on restore. Full examples:
backup and restore.
setup
| Command |
Purpose |
setup / setup all |
Wizard |
setup cursor |
Cursor BYOK (+ --tunnel) |
setup claude-code |
Anthropic env merge |
setup claude-desktop |
Claude Desktop helper |
setup intellij |
JetBrains helper |
setup vscode |
VS Code settings |
setup openai-compat |
SDK env template |
setup models |
Pull recommended models |
setup frontier-key |
Frontier env hints |
setup --undo <client> |
Revert |
route
| Command |
Purpose |
route preview |
Show which tier a prompt would take (--model, --latency-budget-ms) |
Other groups
| Group |
Commands |
context |
clear |
cache |
prune, invalidate (--model, --hash, --team, --key, --token for SSO/master Bearer when calling a running daemon) |
models |
warm (preload configured L3–L5 + embed into Ollama) |
learn |
stats, export-stats, propose-defaults, examples, export-dataset, train-router, finetune, deploy, recommend |
org-cache |
serve |
org-learning |
stats, sync, export |
web-ui |
serve |
project |
init, show |
keys |
create, update, list, revoke, rotate, team-create, team-update, export, import (--priority high\|normal\|low and --max-in-flight N on create / team-create; see keys for list filters) |
enterprise |
bootstrap, policy-sync, policy-status |
service |
install, status, restart, uninstall (user systemd / launchd) |
audit |
list, export, verify |
alerts |
rotate-secret (budget / key-expiry, --secret, --config) |
keys
| Command |
Purpose |
keys list |
Inventory virtual keys |
keys list --status active\|expired\|revoked |
Filter by lifecycle status |
keys list --idle-days N |
Keys whose last_used_at is older than N days (or never used) |
Successful auth updates last_used_at (throttled to once per 60s per key).
Full recipe: virtual keys.
Use daari <cmd> --help for flags.