Command line

todowl is a small command line tool that talks to the same API the AI clients use. Anything you can do in the app, you can do from a terminal.

Install

It ships with the ToDowl source, so you build it once:

git clone https://github.com/supafast-tech/todowl.git
cd todowl && pnpm install --filter @todowl/cli
pnpm --filter @todowl/cli build
cd cli && npm link

Node 22 or newer is required.

Sign in

todowl auth login

That opens a browser, signs you in and stores a fresh API key in ~/.config/todowl/config.json, readable only by you. Already have a key? Use it directly:

todowl auth token todowl_YOUR_KEY

todowl auth status says who you are, todowl auth logout forgets the key on this machine.

Everyday commands

todowl task list --status open
todowl task create --title "Call the bank" --date 2026-09-01 --priority high
todowl task complete a1b2c3d4
todowl task move a1b2c3d4 --project 7f3e1c02
todowl project list
todowl event list --from 2026-09-01 --to 2026-09-07
todowl note list --query invoice
todowl habit checkin 5c9a11de
todowl trash list

Ids are long, so every list prints the first eight characters and every command accepts that short form. If a short id matches more than one thing, the tool says so instead of guessing.

Add --json to any command to get machine-readable output, which is what makes the tool usable inside scripts. todowl --help prints the full command list.

What is covered

Tasks, projects, lists, calendar entries, notes, habits and Trash, with the same rules as the app: deleting moves things to Trash, archiving hides them without deleting, and everything happens under your own account.

Every command, every option and the tool each one calls are in the API reference.