CLI Overview
Understand what the Done Bear CLI covers, who it is for, and where to start.
Use the Done Bear CLI to sign in, pick a workspace, manage tasks, and automate common workflows from the terminal.
Use it for
- Running day-to-day task workflows from a terminal
- Scripting with JSON, CSV, or TSV output
- Setting a default workspace and reusing it across commands
- Generating agent-friendly context with
specandcontext - Importing data from Things 3 into Done Bear
Install and verify
Install the published package:
npm install -g @donebear/cli
donebear --helpCommand groups
| Command | Purpose | Example |
|---|---|---|
auth | Sign in, inspect auth state, and sign out | donebear auth login |
workspace | List, create, join, and target workspaces | donebear workspace use personal |
task | Create and manage tasks and checklist items | donebear task add "Fix bug" --when today |
project | List and update projects | donebear project list --json |
label | List and inspect labels | donebear label list --json |
team | List and inspect teams | donebear team list --json |
today | Show the Today list | donebear today --json |
search | Search tasks by title or notes | donebear search "launch" |
history | Show recent workspace audit history | donebear history --json |
context | Output workspace context for scripts or agents | donebear context --markdown |
spec | Output machine-readable command reference | donebear spec task add |
api-key | Create, list, and revoke API keys | donebear api-key create "CI" |
import things | Import a Things 3 export | donebear import things --dry-run --json |
Workspace targeting
Most commands use your current default workspace. Override it with --workspace or the workspace=<slug> prefix:
donebear workspace use personal
donebear task list
donebear --json task list --workspace personal
donebear workspace=personal task list --jsonNext steps
- Follow Get started with the CLI to install the CLI, sign in, and create your first task.
- Read Automate with tokens, JSON, and context if you are writing scripts or agent workflows.
- Use Command reference when you need the supported flags and command groups in one place.
- Follow Import from Things 3 if you are migrating an existing database.