# 使用 Homebrew, apk, apt, Nix, pacman, winget 安装 todoman

查看 todoman 的安装路径、可执行文件、元数据以及面向 AI 代理工作流的安全说明。

## 安装

```sh
sudo av install brew:todoman
```

其他安装命令:

### macOS

- Homebrew (100%):

```sh
brew install todoman
```

  证据: local Homebrew formula metadata

### Linux

- apk (92%):

```sh
sudo apk add todoman
```

  证据: Alpine Linux edge package indexes: todoman from https://dl-cdn.alpinelinux.org/alpine/edge/community/x86_64/APKINDEX.tar.gz

- Debian apt (92%):

```sh
sudo apt install todoman
```

  证据: Debian stable package indexes: todoman from https://deb.debian.org/debian/dists/stable/main/binary-amd64/Packages.xz

- Nix (92%):

```sh
nix profile install nixpkgs#todoman
```

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

- pacman (92%):

```sh
sudo pacman -S todoman
```

  证据: Arch Linux sync databases: todoman from https://geo.mirror.pkgbuild.com/extra/os/x86_64/extra.db.tar.gz

### Windows

- winget (92%):

```sh
winget install --id evestudio.todo-list -e
```

  证据: Windows Package Manager source index: evestudio.todo-list from https://cdn.winget.microsoft.com/cache/source.msix

## 软件包事实

- **软件包键:** brew:todoman
- **软件包管理器:** Homebrew
- **版本:** 4.7.0
- **来源摘要:** Simple CalDAV-based todo manager
- **主页:** <https://todoman.readthedocs.io/>
- **仓库:** <https://github.com/pimutils/todoman>
- **最后更新:** 2026-07-13T11:43:09Z
- **已生成:** 2026-08-03T19:37:03+00:00

## 可执行文件

- todo (别名)

## 安装行为

- Bottle: 不可用

## 版本和新鲜度

- 页面生成时间: 2026-08-03
- 管理器版本: 4.7.0
## 项目历史与用法

Todoman is a standards-based command-line todo manager from the pimutils ecosystem. It stores tasks as iCalendar VTODO files, which lets users synchronize task lists with CalDAV through tools such as vdirsyncer while still working from a Unix terminal.

### 项目历史

The official README says Todoman is now part of the pimutils project and hosted on GitHub. It describes the tool as a simple CLI task manager whose todos are individual .ics files matching the vdir specification, with support for common todo fields such as summary, description, location, due date, and priority.

The official changelog begins at v2.0.0 and records a mature Python CLI over several major versions. Version 2.0.0 added porcelain output for integrations, configuration validation, due filtering, and persisted todo IDs. Version 3.0.0 added friendlier dates, start filtering, location support, JSON porcelain output, and packaging changes. Version 4.0.0 changed configuration files to plain Python to remove an unmaintained config dependency.

Later releases show continued maintenance for Python and packaging ecosystems: shell completions, Python 3.10/3.11/3.12 support, pyproject.toml, dropped obsolete dependencies, category support, fish completions, and the removal of an old bin/todo wrapper when setuptools entry points became fast enough.

### 采用历史

Todoman's adoption is closely tied to pimutils and vdirsyncer. The README explicitly names CalDAV synchronization through vdirsyncer, and the batch input shows packaging in Homebrew, Debian, Ubuntu, Alpine, Arch, Nix, and other package systems.

The package is aimed at users who want the Taskwarrior or todo.txt style of command-line task management while keeping data in interoperable calendar/task files. Its docs emphasize Unix-like systems and do not support Windows.

### 使用方式

A typical setup points Todoman at a directory of vdir-style .ics files, often synchronized from a CalDAV server by vdirsyncer. Users then create, edit, list, complete, and inspect tasks with the todo command while other calendar clients can still see the underlying VTODO data.

The changelog's porcelain and JSON output work matters for scripts and status-bar integrations, while the plain Python config introduced in v4.0.0 keeps configuration inspectable and package-friendly.

### 为什么软件包爱好者会关心

Todoman is significant to package nerds because it composes with other small Unix PIM tools instead of becoming a monolithic app. It treats tasks as standards-based files, works with CalDAV sync, lives in the pimutils family, and is packaged across many Unix distributions.

It also provides a bridge between CLI task systems and standards-based personal information management: the user gets local files and terminal commands, while the data remains compatible with iCalendar and CalDAV.

### 时间线

- v2.0.0: Added porcelain output, config validation, due filtering, and persisted todo IDs.
- v3.0.0: Added friendlier time display, start filtering, location support, JSON porcelain output, and packaging changes.
- v4.0.0: Switched configuration files to plain Python and dropped the configobj dependency.
- v4.2.0: Added full category support.
- v4.3.0: Added Python 3.11 support and moved to pyproject.toml.
- v4.7.0: Added fish completions, a lists command, JSON list color fields, and dropped Python 3.9 support.

### Related projects

- vdirsyncer is named by the README as the common CalDAV synchronization companion.
- pimutils is the project family that also hosts related personal information management tools.

### 来源

- <https://github.com/pimutils/todoman#readme>
- <https://github.com/pimutils/todoman/blob/main/CHANGELOG.rst>
- <https://todoman.readthedocs.io/en/stable/>
- 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: $XDG_CONFIG_HOME/todoman/config.py, ~/.config/todoman/config.py
## 其他软件包管理器记录

- Debian apt - todoman - 4.5.0-2: normalized package name match | Debian stable package indexes: todoman from https://deb.debian.org/debian/dists/stable/main/binary-amd64/Packages.xz | Simple CalDAV-based todo manager | https://github.com/pimutils/todoman
- Nix - todoman: normalized package name match | nixpkgs package indexes: pkgs/by-name/to/todoman/package.nix from https://api.github.com/repos/NixOS/nixpkgs/git/trees/master?recursive=1
- Ubuntu apt - todoman - 4.4.0-1: normalized package name match | Ubuntu 24.04 LTS package indexes: todoman from https://archive.ubuntu.com/ubuntu/dists/noble/universe/binary-amd64/Packages.gz | Simple CalDAV-based todo manager | https://github.com/pimutils/todoman
- apk - todoman - 4.7.0-r0: normalized package name match | Alpine Linux edge package indexes: todoman from https://dl-cdn.alpinelinux.org/alpine/edge/community/x86_64/APKINDEX.tar.gz | Simple iCalendar-based todo manager | https://pypi.org/project/todoman/
- apk - todoman-bash-completion - 4.7.0-r0: normalized package name match | Alpine Linux edge package indexes: todoman-bash-completion from https://dl-cdn.alpinelinux.org/alpine/edge/community/x86_64/APKINDEX.tar.gz | Bash completions for todoman | https://pypi.org/project/todoman/
- apk - todoman-doc - 4.7.0-r0: normalized package name match | Alpine Linux edge package indexes: todoman-doc from https://dl-cdn.alpinelinux.org/alpine/edge/community/x86_64/APKINDEX.tar.gz | Simple iCalendar-based todo manager (documentation) | https://pypi.org/project/todoman/
- apk - todoman-pyc - 4.7.0-r0: normalized package name match | Alpine Linux edge package indexes: todoman-pyc from https://dl-cdn.alpinelinux.org/alpine/edge/community/x86_64/APKINDEX.tar.gz | Precompiled Python bytecode for todoman | https://pypi.org/project/todoman/
- apk - todoman-repl - 4.7.0-r0: normalized package name match | Alpine Linux edge package indexes: todoman-repl from https://dl-cdn.alpinelinux.org/alpine/edge/community/x86_64/APKINDEX.tar.gz | Simple iCalendar based todo manager (interactive shell) | https://pypi.org/project/todoman/
- apk - todoman-zsh-completion - 4.7.0-r0: normalized package name match | Alpine Linux edge package indexes: todoman-zsh-completion from https://dl-cdn.alpinelinux.org/alpine/edge/community/x86_64/APKINDEX.tar.gz | Zsh completions for todoman | https://pypi.org/project/todoman/
- pacman - todoman - 4.7.0-1: normalized package name match | Arch Linux sync databases: todoman from https://geo.mirror.pkgbuild.com/extra/os/x86_64/extra.db.tar.gz | A simple, standards-based, cli todo (aka: task) manager | https://github.com/pimutils/todoman
- Nix - todo: installed executable or alias match | nixpkgs package indexes: pkgs/by-name/to/todo/package.nix from https://api.github.com/repos/NixOS/nixpkgs/git/trees/master?recursive=1
- winget - evestudio.todo-list: installed executable or alias match | Windows Package Manager source index: evestudio.todo-list from https://cdn.winget.microsoft.com/cache/source.msix


## Combined YAML source

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


## 来源

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