# todoist-cli を Homebrew, MacPorts, Nix, apt でインストール

todoist-cli のインストール経路、実行ファイル、メタデータ、AI エージェント向けセキュリティノートを確認します。

## インストール

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

追加のインストールコマンド:

### macOS

- Homebrew (100%):

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

  証拠: local Homebrew formula metadata

- MacPorts (94%):

```sh
sudo port install todoist-cli
```

  証拠: MacPorts ports tree: office/todoist-cli/Portfile from https://api.github.com/repos/macports/macports-ports/git/trees/master?recursive=1

### Linux

- Nix (92%):

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

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

- Debian apt (92%):

```sh
sudo apt install libtd-dev
```

  証拠: Debian stable package indexes: libtd-dev from https://deb.debian.org/debian/dists/stable/main/binary-amd64/Packages.xz

## パッケージ情報

- **パッケージキー:** brew:todoist-cli
- **パッケージマネージャ:** Homebrew
- **パッケージマネージャページ:** <https://formulae.brew.sh/formula/todoist-cli>
- **バージョン:** 3.1.2
- **ソース概要:** Official command-line interface for Todoist
- **ホームページ:** <https://github.com/Doist/todoist-cli>
- **リポジトリ:** <https://github.com/Doist/todoist-cli>
- **ライセンス:** MIT
- **ソースアーカイブ:** <https://registry.npmjs.org/@doist/todoist-cli/-/todoist-cli-3.1.2.tgz>
- **最終更新:** 2026-08-02T06:16:45Z
- **生成日時:** 2026-08-04T22:13:35+00:00

## 実行可能ファイル

- td (cli)
- td (エイリアス)

## 依存関係

- node

## インストール挙動

- post-install フック: 未定義
- 注意点: 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
- Bottle: 利用可能 対象 arm64_linux, arm64_sequoia, arm64_sonoma, arm64_tahoe, sonoma, x86_64_linux

## バージョンと鮮度

- ページ生成日: 2026-08-04
- マネージャ版: 3.1.2
- マネージャ更新日: 2026-08-02
- ローカルデータ: OK
- 上流リポジトリ: https://github.com/Doist/todoist-cli
- 情報: No cached GitHub release or tag data was available.
## プロジェクトの歴史と使われ方

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.

### プロジェクトの歴史

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.

### 採用の歴史

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.

### 使われ方

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.

### パッケージ好きにとっての重要性

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.

### タイムライン

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

### ソース

- <https://github.com/Doist/todoist-cli#readme>
- <https://github.com/Doist/todoist-cli/blob/main/CHANGELOG.md>
- <https://github.com/Doist/todoist-cli/blob/main/CONTRIBUTING.md>
- source_facts.package-manager


## セキュリティノート

narrow executable package without higher-risk signals.

- **Geiger リスク:** グリーン / 低
- narrow executable package without higher-risk signals


## 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, ~/.config/todoist/cache.json
## ソースデータベース詳細

- **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:** stable

## 他のパッケージマネージャ記録

- Nix - todoist-cli: normalized package name match | nixpkgs package indexes: pkgs/by-name/to/todoist-cli/package.nix from https://api.github.com/repos/NixOS/nixpkgs/git/trees/master?recursive=1
- MacPorts - todoist-cli: normalized package name match | MacPorts ports tree: office/todoist-cli/Portfile from https://api.github.com/repos/macports/macports-ports/git/trees/master?recursive=1
- Debian apt - libtd-dev - 1.8.38~git20241021.d321984+dfsg-4: installed executable or alias match | Debian stable package indexes: libtd-dev from https://deb.debian.org/debian/dists/stable/main/binary-amd64/Packages.xz | telegram database library (development headers) | https://github.com/tdlib/td
- Debian apt - libtd-doc - 1.8.38~git20241021.d321984+dfsg-4: installed executable or alias match | Debian stable package indexes: libtd-doc from https://deb.debian.org/debian/dists/stable/main/binary-amd64/Packages.xz | telegram database library (development documentation) | https://github.com/tdlib/td
- Debian apt - libtd-shim - 1.8.38~git20241021.d321984+dfsg-4: installed executable or alias match | Debian stable package indexes: libtd-shim from https://deb.debian.org/debian/dists/stable/main/binary-amd64/Packages.xz | telegram database library (version-independent CMake shim) | https://github.com/tdlib/td
- Debian apt - libtdjson1.8.38 - 1.8.38~git20241021.d321984+dfsg-4: installed executable or alias match | Debian stable package indexes: libtdjson1.8.38 from https://deb.debian.org/debian/dists/stable/main/binary-amd64/Packages.xz | telegram database library | https://github.com/tdlib/td
- Nix - td: installed executable or alias match | nixpkgs package indexes: pkgs/by-name/td/td/package.nix from https://api.github.com/repos/NixOS/nixpkgs/git/trees/master?recursive=1


## 関連リンク

- [Source-control packages](https://pkg.so/ja/source-control-tools/) - Belongs to a source-control command family.
- [Terminal utility packages](https://pkg.so/ja/terminal-utilities/) - Matched terminal and command-line workflow metadata.
- [Networking and protocol packages](https://pkg.so/ja/networking-protocol-tools/) - Matched network, protocol, or remote-service metadata.
- [Web development packages](https://pkg.so/ja/web-dev-tools/) - Matched web development metadata.
- [node](https://pkg.so/ja/brew/node/) - Runtime dependency declared by Homebrew.
- [todoist-cli-go](https://pkg.so/ja/brew/todoist-cli-go/) - Shares pkgdb curated category or tags: cli, productivity, task-management, todoist.
- [yamlresume](https://pkg.so/ja/brew/yamlresume/) - Shares pkgdb curated category or tags: cli, productivity, typescript.
- [todo-txt](https://pkg.so/ja/brew/todo-txt/) - Shares pkgdb curated category or tags: cli, productivity, task-management.
- [ttdl](https://pkg.so/ja/brew/ttdl/) - Shares pkgdb curated category or tags: cli, productivity, task-management.
- [vit](https://pkg.so/ja/brew/vit/) - Shares pkgdb curated category or tags: cli, productivity, task-management.
- [tuxedo](https://pkg.so/ja/brew/tuxedo/) - Shares pkgdb curated category or tags: cli, productivity, task-management.
- [todoman](https://pkg.so/ja/brew/todoman/) - Shares pkgdb curated category or tags: cli, productivity, task-management.
- [taskline](https://pkg.so/ja/brew/taskline/) - Shares pkgdb curated category or tags: cli, productivity, task-management.
- [backlog-md](https://pkg.so/ja/brew/backlog-md/) - Both packages touch the same language runtime or ecosystem. Shared terms: cli, management, node, productivity, task.

## Combined YAML source

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


## ソース

- pkg.so package database
- Geiger risk classifier
- package-page enrichment
- curated configuration and credential file locations
- curated package history
- package version freshness
- pkgdb category and tag curation
- package relationship graph
- external package-manager database matches
- cross-ecosystem install command graph
