todoist-cli
brew install todoist-cli
v1.75.0
MIT
Official command-line interface for Todoist
884
30-day installs · #1366
1.2k
90-day · #2027
2.0k
365-day · #2840
226
★ GitHub stars · updated 2mo ago
Runtime dependencies
GitHub topics
agent-skills
Links
- https://github.com/Doist/todoist-cli
- GitHub: Doist/todoist-cli
- Brew formula source: Formula/t/todoist-cli.rb
Caveats
Looking for the third-party Go CLI previously published under this name (by sachaos)? It has been renamed. Install it with: brew install todoist-cli-go
Raw metadata
{
"aliases": [],
"alternatives": [],
"build_dependencies": [],
"categories": [],
"caveats": "Looking for the third-party Go CLI previously published under this\nname (by sachaos)? It has been renamed. Install it with:\n brew install todoist-cli-go\n",
"conflicts_with": [],
"dependencies": [
"node"
],
"deprecated": 0,
"deprecation_reason": null,
"desc": "Official command-line interface for Todoist",
"disable_reason": null,
"disabled": 0,
"enrichment_fetched_at": "2026-06-20T23:41:27+00:00",
"first_seen": "2026-06-20T23:34:18+00:00",
"full_name": "todoist-cli",
"github_default_branch": "main",
"github_last_commit_at": "2026-06-17T10:11:38Z",
"github_readme_excerpt": "\u003cp align=\"center\"\u003e\n \u003cimg src=\"icons/td-cli.png\" alt=\"Todoist CLI\" width=\"150\" height=\"150\" /\u003e\n\u003c/p\u003e\n\n# Todoist CLI\n\nA command-line interface for Todoist.\n\n\u003e [!NOTE]\n\u003e If you have come here after upgrading your `todoist-cli` package in Homebrew and it is not what you were expecting, you may have been using what is now [`todoist-cli-go`](https://formulae.brew.sh/formula/todoist-cli-go).\n\n## Installation\n\n\u003e ```bash\n\u003e npm install -g @doist/todoist-cli\n\u003e ```\n\n### Agent Skills\n\nInstall skills for your coding agent:\n\n```bash\ntd skill install claude-code\ntd skill install codex\ntd skill install copilot\ntd skill install cursor\ntd skill install gemini\ntd skill install pi\ntd skill install universal\n```\n\nSkills are installed to `~/\u003cagent-dir\u003e/skills/todoist-cli/SKILL.md` (e.g. `~/.claude/` for claude-code, `~/.agents/` for universal, etc.). When updating the CLI, installed skills are updated automatically. The `universal` agent is compatible with Amp, OpenCode, and other agents that read from `~/.agents/`.\n\n```bash\ntd skill list\ntd skill uninstall \u003cagent\u003e\n```\n\n## Uninstallation\n\nFirst, remove any installed agent skills:\n\n```bash\ntd skill uninstall \u003cagent\u003e\n```\n\nThen uninstall the CLI:\n\n```bash\nnpm uninstall -g @doist/todoist-cli\n```\n\n## Local Setup\n\n```bash\ngit clone https://github.com/Doist/todoist-cli.git\ncd todoist-cli\nnpm install\nnpm run build\nnpm link\n```\n\nThis makes the `td` command available globally.\n\n## Setup\n\n```bash\ntd auth login\n```\n\nThis opens your browser to authenticate with Todoist. Once approved, the token is stored in your OS credential manager:\n\n- macOS: Keychain\n- Windows: Credential Manager\n- Linux: Secret Service/libsecret\n\nIf secure storage is unavailable, the CLI warns and falls back to `~/.config/todoist-cli/config.json`. Existing plaintext tokens are migrated automatically the next time the CLI reads them successfully from the config file.\n\nFor a read-only OAuth token (scope `data:read`), run:\n\n```bash\ntd auth login --read-only\n```\n\nIn read-only mode, co",
"github_repo": "Doist/todoist-cli",
"github_stars": 226,
"github_topics": [
"agent-skills"
],
"homepage": "https://github.com/Doist/todoist-cli",
"homepage_og_description": null,
"homepage_og_image": null,
"homepage_title": null,
"installs_30d": 884,
"installs_365d": 1975,
"installs_90d": 1193,
"keg_only": 0,
"keg_only_reason": null,
"last_seen": "2026-06-20T23:34:18+00:00",
"license": "MIT",
"llm_generated_at": null,
"llm_model": null,
"name": "todoist-cli",
"oldnames": [],
"one_liner": null,
"optional_dependencies": [],
"rank_30d": 1366,
"rank_365d": 2840,
"rank_90d": 2027,
"raw_hash": "267604930991e7ab",
"recommended_dependencies": [],
"revision": 0,
"ruby_source_path": "Formula/t/todoist-cli.rb",
"tap": "homebrew/core",
"test_dependencies": [],
"uses_from_macos": [],
"version_head": null,
"version_stable": "1.75.0",
"versioned_formulae": [],
"why_use_this": null
}