Todoist CLI (todoist-cli)

Agent-first Todoist CLI. All output is structured JSON with next_actions hints.

Auth

Token resolves automatically: TODOIST_API_TOKEN env var → secrets lease todoist_api_token (agent-secrets).

Ref Resolution

All <ref> args accept: task name (fuzzy matched), Todoist URL, id:xxx, or raw ID. Project args (--project) also resolve by name.

todoist-cli complete "Buy milk"                                    # by name
todoist-cli show https://app.todoist.com/app/task/buy-milk-8abc    # by URL
todoist-cli show id:6g3VHV5HJGvJmPhw                              # by id: prefix