# Done Bear in your terminal

> Run your Done Bear list from the terminal, scripts, cron and CI. Every change syncs to the apps. Free for up to 250 tasks.

## Install and sign in

```bash
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.

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

### Run it from scripts and CI

JSON, CSV, TSV or count-only output. An API key lets CI and cron skip the browser login.

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

### Import from Things 3

On the Mac with Things installed, preview the migration, then import areas, projects, tags and tasks.

```bash
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`. `donebear --help` lists every command.

### Can I use the CLI in scripts and CI?

Yes. Add `--json`, `--format csv` or `--format tsv`, and set `DONEBEAR_TOKEN` to an API key instead of using browser login.

---

[Create a workspace](https://app.donebear.com) or read the [CLI docs](/docs/cli/get-started).

---

Every Done Bear page is listed at https://donebear.com/llms.txt. Any page has a markdown copy at its URL plus `.md`. Start from the map rather than guessing a path.