Todoist CLI

A command-line interface for Todoist.

Installation

Note: This package is not yet published to npm. Once published, install with:

npm install -g @doist/todoist-cli

Local Setup (for now)

git clone https://github.com/Doist/todoist-cli.git
cd todoist-cli
npm install
npm run build
npm link

This makes the td command available globally.

Setup

td auth login

This opens your browser to authenticate with Todoist. Once approved, the token is saved automatically.

Alternative methods

Manual token: Get your API token from Todoist Settings > Integrations > Developer:

td auth token "your-token"

Environment variable:

export TODOIST_API_TOKEN="your-token"

Auth commands

td auth status   # check if authenticated
td auth logout   # remove saved token

Usage

td add "Buy milk tomorrow #Shopping"   # quick add with natural language
td today                               # tasks due today + overdue
td inbox                               # inbox tasks
td task list                           # all tasks
td task list --project "Work"          # tasks in project
td project list                        # all projects

Run td --help or td <command> --help for more options.

Development

npm install
npm run build       # compile
npm run dev         # watch mode
npm run type-check  # type check
npm run format      # format code
npm test            # run tests