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

CLI for Todoist. Version 0.24.0 via Homebrew; verified 2026-05-22.

## Install

```sh
sudo av install brew:todoist-cli-go
```

Additional install commands:

### macOS

- Homebrew (100%):

```sh
brew install todoist-cli-go
```

  Evidence: local Homebrew formula metadata

### Linux

- Nix (92%):

```sh
nix profile install nixpkgs#todoist
```

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

### Windows

- Chocolatey (92%):

```sh
choco install todoist
```

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

- winget (92%):

```sh
winget install --id Doist.Todoist -e
```

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

## Package facts

- **Package key:** brew:todoist-cli-go
- **Package manager:** Homebrew
- **Package manager page:** <https://formulae.brew.sh/formula/todoist-cli-go>
- **Version:** 0.24.0
- **Source summary:** CLI for Todoist
- **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
- **Generated:** 2026-07-08T07:18:31+00:00

## Executables

- todoist (cli)
- todoist (alias)

## Build dependencies

- go

## Install behavior

- Post-install hook: not defined
- 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).
- Bottle: available on arm64_linux, arm64_sequoia, arm64_sonoma, arm64_tahoe, sonoma, x86_64_linux

## Freshness

- Page generated: 2026-07-08
- Package-manager version: 0.24.0
- Package-manager updated: 2026-05-22
- Local data: ok
- Upstream repository: https://github.com/sachaos/todoist
- Upstream latest detected: v0.24.0 (current)
## 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 Notes

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.



## 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

- Unix: ~/.config/todoist/config.json

## Credential files

- Unix: ~/.config/todoist/config.json
## 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

## Other Package-Manager Records

- Nix - todoist: installed executable or alias match | nixpkgs package indexes: pkgs/by-name/to/todoist/package.nix from https://api.github.com/repos/NixOS/nixpkgs/git/trees/master?recursive=1
- Chocolatey - todoist: installed executable or alias match | Chocolatey community package catalog: todoist from http://community.chocolatey.org/api/v2/Packages?$filter=IsLatestVersion&$select=Id&$top=1000&$skiptoken='6.5836','capture'
- winget - Doist.Todoist: installed executable or alias match | Windows Package Manager source index: Doist.Todoist from https://cdn.winget.microsoft.com/cache/source.msix


## Related links

- [Source-control packages](https://www.automicvault.com/pkg/source-control-tools/) - Belongs to a source-control command family.
- [Terminal utility packages](https://www.automicvault.com/pkg/terminal-utilities/) - Matched terminal and command-line workflow metadata.
- [Language runtime packages](https://www.automicvault.com/pkg/language-runtime-packages/) - Matched language runtime, compiler, or interpreter metadata.
- [Networking and protocol packages](https://www.automicvault.com/pkg/networking-protocol-tools/) - Matched network, protocol, or remote-service metadata.
- [go](https://www.automicvault.com/pkg/brew/go/) - Build dependency declared by Homebrew.
- [todoist-cli](https://www.automicvault.com/pkg/brew/todoist-cli/) - Shares av.db curated category or tags: cli, productivity, task-management, todoist.
- [pter](https://www.automicvault.com/pkg/brew/pter/) - Shares av.db curated category or tags: cli, productivity, task-management.
- [taskline](https://www.automicvault.com/pkg/brew/taskline/) - Shares av.db curated category or tags: cli, productivity, task-management.
- [todo-txt](https://www.automicvault.com/pkg/brew/todo-txt/) - Shares av.db curated category or tags: cli, productivity, task-management.
- [todoman](https://www.automicvault.com/pkg/brew/todoman/) - Shares av.db curated category or tags: cli, productivity, task-management.
- [topydo](https://www.automicvault.com/pkg/brew/topydo/) - Shares av.db curated category or tags: cli, productivity, task-management.
- [ttdl](https://www.automicvault.com/pkg/brew/ttdl/) - Shares av.db curated category or tags: cli, productivity, task-management.
- [ultralist](https://www.automicvault.com/pkg/brew/ultralist/) - Shares av.db curated category or tags: cli, productivity, task-management.

## Combined YAML source

View the package source record on GitHub. [combined/todoist-cli-go.yml](https://github.com/automic-vault/db/blob/main/combined/todoist-cli-go.yml)


## Sources

- Nucleus package database
- package-page enrichment
- curated configuration and credential file locations
- curated package history
- package version freshness
- av.db category and tag curation
- package relationship graph
- external package-manager database matches
- cross-ecosystem install command graph
