macOS
Homebrewverified · 100%
brew install todoist-clilocal Homebrew formula metadata
MacPortsverified · 94%
sudo port install todoist-cliMacPorts ports tree · office/todoist-cli/Portfile · source: api.github.com
brew
Install todoist-cli with Homebrew, MacPorts
Official command-line interface for Todoist. Version 1.76.0 via Homebrew; verified 2026-07-07.
install
Additional install commands
overview
Package summary
Official command-line interface for Todoist
Project links
Commands and aliases
No executable aliases were found in the local package database.
history
Project history and usage
Todoist CLI is Doist's official command-line interface for Todoist, installed as the td command. It represents Todoist's vendor-maintained move into terminal workflows, OAuth-based authentication, shell completion, and coding-agent skill installation.
Project history
The official repository describes Todoist CLI simply as a command-line interface for Todoist and installs it from npm as @doist/todoist-cli. The changelog begins with 1.0.0 on 2026-01-16 and shows rapid 1.x development through 2026, with semantic-release automation documented in CONTRIBUTING.md.
The README documents browser-based Todoist authentication, read-only OAuth mode, optional additional OAuth scopes, manual token and environment-variable authentication, OS credential-manager storage, and a plaintext fallback config path. This is a more vendor-integrated model than older unofficial Todoist CLIs, which typically relied directly on user API tokens.
By mid-2026 the changelog shows many feature additions beyond basic tasks: accounts, projects, sections, labels, comments, reminders, billing, apps, backups, goals, Markdown output behavior, and Todoist SDK upgrades. The README also documents installing agent skills for tools such as codex, claude-code, copilot, cursor, gemini, pi, and universal.
Adoption history
The input metadata shows the official CLI packaged by Homebrew, MacPorts, Nix, and Debian metadata, while the README uses npm as the primary installation channel. In Homebrew, this package occupies the todoist-cli name, while the older Go client is named todoist-cli-go.
The agent-skill commands are a notable adoption signal for the current package-nerd niche: Todoist CLI is not only for humans at a shell prompt, but also for local coding agents that can read a Todoist-specific skill and operate through td.
How it is used
Users authenticate with td auth login, then run commands such as td add, td today, td inbox, td task list, td project list, and td task view. The README also documents shell completions for bash, zsh, and fish, accessibility flags, read-only mode, additional OAuth scopes, and environment-token fallback.
Package-conscious users care about where credentials land. The official README says tokens are stored in macOS Keychain, Windows Credential Manager, or Linux Secret Service/libsecret when available, with a warning and fallback to ~/.config/todoist-cli/config.json if secure storage is unavailable.
Why package nerds care
Todoist CLI is significant because it turns a hosted task system into a first-party terminal tool with npm, Homebrew, MacPorts, and Nix packaging. It also clarifies the package-name collision with the earlier Go client in this batch.
Its 2026 agent-skill support makes it especially relevant to package nerds building local AI or automation stacks: it packages not just a CLI, but also command knowledge for agents to install into their own skill directories.
Timeline
- 2026-01-16: 1.0.0 appears as the first official changelog entry.
- 2026-03-31: 1.34.0 added read-only OAuth mode for safer autonomous tool use.
- 2026-05-07: 1.62.0 added GitHub Copilot skill installation instructions.
- 2026-06-29: 1.75.3 fixed Pi skill installation in the agent directory.
Related projects
- sachaos/todoist is the older unofficial Go Todoist CLI that Homebrew now names todoist-cli-go.
- The CLI depends on Doist's Todoist SDK according to the official changelog.
Sources
security posture
Risk level: green
narrow executable package without higher-risk signals.
Risk classifier
green risk · low confidence · appliance
Why
- narrow executable package without higher-risk signals
Signals
- metadata:no-higher-risk-signals
Install behavior
- No Homebrew post-install hook is recorded in formula metadata.
- Homebrew bottle metadata is available for 6 platform targets.
- Installs with 1 runtime dependencies.
Recommended review
Before unattended agent use, check whether the tool reads plaintext credentials, writes remote state, publishes artifacts, or shells out to plugins.
local files
Configuration and credential file locations
These source-backed paths show where this package keeps local settings or durable credentials. Automic Vault can use them as review targets for secret scanning, migration, and command approval.
Configuration files
Config paths the tool may read or write during local use.
- Unix
~/.config/todoist/config.json
Credential files
Credential-bearing paths to review before unattended agent runs.
- Unix
~/.config/todoist/config.json~/.config/todoist/cache.json
executables
Installed executables
| Command | Kind | Exposure | Note |
|---|---|---|---|
| No executable data was present. | |||
freshness
Version and freshness
These signals separate page generation age, package-manager activity, and upstream release comparison. Version lag is warned only when an evidence URL and comparable versions are present.
page generated2026-07-08
manager version1.76.0
manager updated2026-07-07
local dataok
upstreamnot checked
latest detectednot detected
https://github.com/Doist/todoist-cli
- infoNo cached GitHub release or tag data was available.https://github.com/Doist/todoist-clinone confidence
install metadata
Package metadata
| Package key | brew:todoist-cli |
|---|---|
| Version | 1.76.0 |
| Package manager | Homebrew |
| Package manager page | https://formulae.brew.sh/formula/todoist-cli |
| Homepage | https://github.com/Doist/todoist-cli |
| Repository | https://github.com/Doist/todoist-cli |
| Upstream docs | https://github.com/Doist/todoist-cli#readme |
| License | MIT |
| Source archive | https://registry.npmjs.org/@doist/todoist-cli/-/todoist-cli-1.76.0.tgz |
| Last updated | 2026-07-07T16:37:47Z |
| Pulse | updated |
| Dependencies | node |
| Bottle | available (on arm64_linux, arm64_sequoia, arm64_sonoma, arm64_tahoe, sonoma, x86_64_linux) |
| Homebrew post-install | not defined |
| Service | none declared |
| 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 |
registry facts
Source database details
| Source Database | Homebrew formula API |
|---|---|
| Tap | homebrew/core |
| Full Name | todoist-cli |
| Version Scheme | 0 |
| Revision | 0 |
| Bottle Stable Root URL | https://ghcr.io/v2/homebrew/core |
| Deprecated | no |
| Disabled | no |
| Keg Only | no |
| URL Keys |
|
source database matches
Other package-manager records
Matches are pulled from external package-manager indexes and kept separate from local Automic Vault package links.
MacPorts95%
todoist-cli
sudo port install todoist-cli- normalized package name match
- Matched by: Todoist Cli
source trail
Generated from repository data
This page is generated by av-web from the private package SQLite artifact built by scripts/generate-pkg-sqlite.py.
Combined YAML source
View the package source record on GitHub.
Used sources
- Geiger risk classifier
- Nucleus package database
- av.db category and tag curation
- cross-ecosystem install command graph
- curated configuration and credential file locations
- curated package history
- external package-manager database matches
- package relationship graph
- package version freshness
- package-page enrichment