Skip to content
For the complete documentation index, see llms.txt.

A task manager CLI built for automation

Capture, search, and complete tasks from the terminal. JSON output and API-key auth make it scriptable, while every change syncs to the apps. Free for up to 250 tasks.

Install and sign in

npm install -g donebear
donebear auth login

What the Done Bear CLI does

Run your list from the terminal

Capture, find, schedule, and complete tasks without leaving the shell. Every change syncs to the apps.

donebear task add "Fix the flaky deploy test" --when today
donebear today
donebear search "invoice"
donebear task done 8f2c

Machine-readable output and CI auth

Use JSON, CSV, TSV, or count-only output in scripts. API keys remove browser login from CI and cron.

donebear task list --json
donebear search "blocked" --total
donebear api-key create "CI"
export DONEBEAR_TOKEN=<token>

Import from Things 3 in one command

Preview the migration, then import Things areas, projects, tags, and tasks in one command.

donebear import things --dry-run
donebear import things

Frequently asked questions

How do I install the Done Bear CLI?

Run `npm install -g donebear`, then `donebear auth login`. Use `donebear --help` to see every command.

Can I use the CLI in scripts and CI?

Yes. Add `--json`, `--format csv`, or `--format tsv`. For CI, create a key and set `DONEBEAR_TOKEN` instead of using browser login.

Can I import my Things 3 tasks from the terminal?

Run `donebear import things --dry-run` on the Mac with Things installed, then remove `--dry-run` to migrate areas, projects, and tasks.