AI agents: fetch the documentation index at llms.txt. Markdown versions are available by appending .md to any page URL, including this page's markdown.
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
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.