install

Additional install commands

macOS

Homebrewverified · 100%

brew install todoist-cli-go

local Homebrew formula metadata

Linux

Nixverified · 92%

nix profile install nixpkgs#todoist

nixpkgs package indexes · pkgs/by-name/to/todoist/package.nix · source: api.github.com

Windows

Chocolateyverified · 92%

choco install todoist

Chocolatey community package catalog · todoist · source: community.chocolatey.org

Windows Package Managerverified · 92%

winget install --id Doist.Todoist -e

Windows Package Manager source index · Doist.Todoist · source: cdn.winget.microsoft.com

overview

Package summary

CLI for Todoist

Project links

Commands and aliases

todoist

history

Project history and usage

todoist-cli-go is an unofficial Go command-line client for Todoist. It predates the current official Doist td CLI in Homebrew and remains notable as a terminal-first Todoist wrapper with local cache, API-token configuration, and integrations with fuzzy finders.

Project history

The official README identifies the project as an unofficial Todoist CLI client written in Go. It documents commands for listing, showing, adding, modifying, closing, reopening, deleting, syncing, and quick-adding Todoist tasks.

The README now distinguishes the Homebrew formula name todoist-cli-go from the official Doist todoist-cli formula, noting that the formula was renamed to make room for the official CLI. It also warns that users must upgrade to v0.23 or later before February 10, 2026 because older versions depend on Todoist APIs scheduled for shutdown.

Adoption history

The project documents installation through Homebrew, the author's tap, AUR packages, Nix/NixOS, Docker, and source builds. That distribution pattern is typical of a popular unofficial CLI: it spread through package managers before the vendor-maintained command arrived.

How it is used

Users register a Todoist API token, run todoist sync, and then use subcommands for task and project operations. The README recommends peco or fzf shell functions for interactive selection, which places the tool in a classic terminal productivity workflow.

Why package nerds care

The package is significant mostly as a naming and migration story. Homebrew users who knew todoist-cli as the Go client later had to distinguish todoist-cli-go from Doist's official todoist-cli, and the README makes that package-name split explicit.

Timeline

Pre-2026: Distributed as an unofficial Todoist CLI client through Homebrew, AUR, Nix, Docker, and source builds.
2026: README warns users to upgrade to v0.23 or later before Todoist API shutdown on February 10, 2026.
2026: README notes the Homebrew formula rename to todoist-cli-go to make room for the official Doist CLI.

Related projects

Doist/todoist-cli is the official Todoist CLI and is named in the README as a separate tool.
peco and fzf are documented as recommended interactive helpers.

Sources

current_curation.repo
https://github.com/sachaos/todoist#readme
source_facts.package-manager

security posture

No protected-tool coverage found yet

No matching local secret-handling manifest was found for todoist-cli-go. Nucleus package metadata is still published here so future coverage has a stable package URL.

Install behavior

No Homebrew post-install hook is recorded in formula metadata.
Homebrew bottle metadata is available for 6 platform targets.
Build metadata lists 1 build 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

executables

Installed executables

Command	Kind	Exposure	Note
`todoist`	cli	global executable

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 version0.24.0

manager updated2026-05-22

local dataok

upstreamcurrent

latest detectedv0.24.0

https://github.com/sachaos/todoist

okNo freshness warnings were generated.

install metadata

Package metadata

Package key	brew:todoist-cli-go
Version	0.24.0
Package manager	Homebrew
Package manager page	https://formulae.brew.sh/formula/todoist-cli-go
Homepage	https://github.com/sachaos/todoist
Repository	https://github.com/sachaos/todoist
Upstream docs	https://github.com/sachaos/todoist#readme
License	MIT
Source archive	https://github.com/sachaos/todoist/archive/refs/tags/v0.24.0.tar.gz
Last updated	2026-05-22T18:04:04Z
Pulse	updated
Build dependencies	go
Bottle	available (on arm64_linux, arm64_sequoia, arm64_sonoma, arm64_tahoe, sonoma, x86_64_linux)
Homebrew post-install	not defined
Service	none declared
Caveats	This formula was renamed from "todoist-cli" to "todoist-cli-go" to free up the "todoist-cli" name for the official Doist CLI (https://github.com/Doist/todoist-cli).

registry facts

Source database details

Source Database	Homebrew formula API
Tap	homebrew/core
Full Name	todoist-cli-go
Version Scheme	0
Revision	0
Head Version	HEAD
Bottle Stable Root URL	https://ghcr.io/v2/homebrew/core
Deprecated	no
Disabled	no
Keg Only	no
URL Keys	head stable

source database matches

Other package-manager records

Matches are pulled from external package-manager indexes and kept separate from local Automic Vault package links.

Nix92%

todoist

nix profile install nixpkgs#todoist

installed executable or alias match
Matched by: Todoist

nixpkgs package indexes · api.github.com · nixpkgs package indexes: pkgs/by-name/to/todoist/package.nix from https://api.github.com/repos/NixOS/nixpkgs/git/trees/master?recursive=1

Chocolatey92%

todoist

choco install todoist

installed executable or alias match
Matched by: Todoist

Chocolatey community package catalog · community.chocolatey.org · Chocolatey community package catalog: todoist from http://community.chocolatey.org/api/v2/Packages?$filter=IsLatestVersion&$select=Id&$top=1000&$skiptoken='6.5836','capture'

winget92%

Doist.Todoist

winget install --id Doist.Todoist -e

installed executable or alias match
Matched by: Todoist

Windows Package Manager source index · cdn.winget.microsoft.com · Windows Package Manager source index: Doist.Todoist from https://cdn.winget.microsoft.com/cache/source.msix

package graph

Links come from deterministic package relationships, av.db category and tag curation, ecosystem matches, and package hub membership.

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.

combined/todoist-cli-go.yml

Used sources

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

Install todoist-cli-go with Homebrew, chocolatey, Nix, winget