A command-line interface for Todoist.
npm install -g @doist/todoist-cli
git clone https://github.com/Doist/todoist-cli.git
cd todoist-cli
npm install
npm run build
npm linkThis makes the td command available globally.
td auth login
This opens your browser to authenticate with Todoist. Once approved, the token is saved automatically.
Manual token: Get your API token from Todoist Settings > Integrations > Developer:
td auth token "your-token"Environment variable:
export TODOIST_API_TOKEN="your-token"
td auth status # check if authenticated td auth logout # remove saved token
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 td task view https://app.todoist.com/app/task/buy-milk-8Jx4mVr72kPn3QwB # paste a URL
Run td --help or td <command> --help for more options.
Tab completion is available for bash, zsh, and fish:
td completion install # prompts for shell td completion install bash # or: zsh, fish
Restart your shell or source your config file to activate. To remove:
td completion uninstall
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