Command Reference Reference the supported Done Bear CLI command groups, global flags, and common workflows.
This reference lists the public CLI command groups and the flags you can rely on today. Use it when you already know what you want to do and need the exact command shape.
These flags work at the root level:
Flag Purpose --jsonOutput machine-readable JSON --formatChoose text, json, csv, or tsv --copyCopy the result to the clipboard --totalPrint only the count --tokenOverride auth for one command --api-urlOverride the API base URL --debugEnable debug logging --no-colorDisable ANSI colors
The CLI supports both explicit workspace flags and the workspace prefix shortcut:
donebear task list --workspace personal --json donebear workspace=personal task list --json Command Purpose Notes donebear auth loginStart OAuth login in the browser Supports --port, --timeout, --no-open donebear auth statusShow the current auth state Use --json for scripts donebear auth logoutClear the stored session Does not revoke API keys donebear whoamiShow the current user Alias: donebear me
Command Purpose Key options donebear workspace listList available workspaces none donebear workspace currentShow the current default workspace none donebear workspace useSet the default workspace workspace id, slug, or exact name donebear workspace clearClear the default workspace none donebear workspace createCreate a workspace --slug, --logo-url, --no-usedonebear workspace joinJoin with an invite code --no-usedonebear workspace members [workspace]List members --format, --totaldonebear workspace invitations [workspace]List pending invitations none donebear workspace invite [workspace]Create an invitation --email, --role with member or admin
Command Purpose Key options donebear task listList tasks --workspace, --state, --limit, --searchdonebear task showShow task details --workspacedonebear task readPrint task notes only --workspacedonebear task addCreate a task --when, --notes, --deadline, --project, --team, --workspacedonebear task editUpdate task fields --title, --notes, --clear-notes, --when, --deadline, --clear-deadline, --project, --clear-project, --team, --clear-team, --workspacedonebear task doneComplete a task --workspacedonebear task reopenReopen a task --workspacedonebear task archiveArchive a task --workspacedonebear task unarchiveRestore an archived task --workspacedonebear task appendAppend notes --workspacedonebear task prependPrepend notes --workspacedonebear task randomShow a random task --workspace, --state
Task IDs accept a full UUID or a unique prefix of at least four characters.
donebear task checklist manages checklist items for one task.
Command Purpose donebear task checklistList checklist items donebear task checklist addAdd a checklist item donebear task checklist doneComplete a checklist item donebear task checklist reopenReopen a checklist item donebear task checklist editRename a checklist item donebear task checklist removeRemove a checklist item
Command group Purpose donebear projectList, show, create, edit, complete, archive, and restore projects donebear labelList and show labels donebear teamList and show teams
Example:
donebear project add "Q2 Launch" --target-date 2026-06-30 donebear label list --json donebear team show ENG --json Command Purpose donebear todayList open tasks in the Today bucket donebear searchSearch task titles and notes donebear historyShow recent workspace audit history donebear contextOutput a workspace snapshot in JSON or Markdown donebear specOutput machine-readable command documentation
Command Purpose donebear import thingsImport a Things 3 SQLite export donebear api-key createCreate an API key donebear api-key listList API keys donebear api-key revokeRevoke an API key
donebear task list --state done --limit 50 --json donebear search "launch" --format csv donebear context --markdown donebear spec task add donebear import things --dry-run --json