登录

todo.txt-cli

todotxtGPL-3.0活跃维护

用纯 Shell 脚本管理 todo.txt 纯文本待办文件，支持增删改查、过滤和扩展，适合喜欢命令行和纯文本工作流的用户。

☑️ A simple and extensible shell script for managing your todo.txt file.

v2.14.0发布于 2026-09-01 17:37 UTC6,198star732fork同步于 2026-11-10 17:35 UTC
待办管理纯文本命令行Shell 脚本todo.txt
对比 GitHub 官网clilinuxshelltodotodo-cli

怎么上手

由 README 提炼，执行前请确认
原文 
brew install todo-txt
cp -n $(brew --prefix)/opt/todo-txt/todo.cfg ~/.todo.cfg
硬件要求按 README 说明

README 未说明，作为 Shell 脚本无特殊硬件要求

下载：源码 zip·GitHub Releases（安装包）本站不镜像安装包

项目说明

由 README 自动翻译提炼
没人工点评？写下你的经验

用 Shell 脚本管理 todo.txt 文件的命令行工具，简单且可扩展

用纯 Shell 脚本管理 todo.txt 纯文本待办文件，支持增删改查、过滤和扩展，适合喜欢命令行和纯文本工作流的用户。

核心能力

  • 用 todo.sh 命令增删改查 todo.txt 任务
  • 支持 +project 和 @context 标记任务
  • 提供配置文件模板，可自定义目录、颜色和高亮
  • 附带 Bash 自动补全脚本
  • 可通过 Makefile 指定安装路径

容易踩的坑

macOS 用 cp -n 避免覆盖已有配置文件；Linux 用 make install 时需按系统调整 INSTALL_DIR、CONFIG_DIR 等默认路径；建议把配置模板复制到 todo.sh help 列出的位置而非直接用全局配置

内容由模型根据 README 生成，可能不完整或不准确，以官方文档为准。看原文 README

最近发版

5 个版本v2.14.0
全部 release
  1. v2.14.0最新正式版2026-09-01 · 2026-09-01 17:37 UTC

    Added

    • TODOTXT_DEFAULT_ACTION now also allows action parameters ([#159], [#407])

    Changed

    • Improve compatibility with non-GNU sed command on BSD/Busybox ([#447])

    Fixed

    • make install installed the Bash completion in the wrong directory ([#452])
    • make uninstall fails ([#451])
    • Configured file locations can now be overridden ([#460])

    Security

  2. v2.13.02024-12-25 · 2024-12-25 10:30 UTC
    查看更新说明

    Added

    • listpri action allows concatenation of multiple priorities [-ranges]
    • replace action completely merges any combination of priority / date with existing (#386)
    • Check for broken symlinks to custom actions and complain (#359)

    Changed

    • Add .sh extension to completion script
    • Reuse the todo.sh alias for completion
    • Return from user prompt without requiring Enter (#354)
    • Default to user writable directory in config (#148)

    Fixed

    • Fix problem with spaces in directory path (#276)
    • pri action takes multiple items + priorities on single run (#346)
  3. v2.12.02020-08-12 · 2020-08-12 04:38 UTC
    查看更新说明

    Added

    • Added default priority variable TODOTXT_PRIORITY_ON_ADD (#246)
    • Added done option as alias of do (#169)
    • Added macOS 10.15.x support (#300)
    • Highlighting of dates, metadata and item numbers (#264)
    • Minimal config file / default filenames (todo.txt, done.txt, report.txt) (#289)
    • Enable file completion for add-on actions via _todo_file{1,2,3}_actions (#270)
    • Allow to customize what can be before / inside / after +project and @context (#271)

    Changed

    • Read the task's name and uses as default (#249)
    • Updated interpreter reference to use environment variable (#160)
    • Allow setting of bash completion path (#301)

    Fixes

    • Fixed no end-of-line bug. Supports todos with no end-of-line. (#295)

    Thank you @inkarkat, @karbassi, @tpikonen, @kh80, @eightyfive, @otizonaizit, @guifeliper, and @dikeert for all the hard work and PRs.

  4. v2.11.02018-03-26 · 2018-03-26 16:13 UTC
    查看更新说明

    Added

    Changed

    • Updated add command to accept lowercase priority (#230)
    • Clean tests and version file in Makefile. Don't ignore errors in tests.
    • Updated README.md (#219)
    • Update Downloads links to point at the Releases page (#228)
    • Set the executable bit when preparing releases (#156)

    Fixes

    • Update links to use https
    • Suppress todo.sh error messages when invoked during completion ([#8])
  5. v2.10.0Version 2.10.02013-12-06 · 2013-12-06 08:53 UTC
    查看更新说明

    Enhancements:

    • Enable term filtering for listcon.
    • Add make install command.
    • Enable use of global config file in /etc/todo/config. make install installs a global config file.
    • Allow use of post_filter_command for listall and listpri.
    • Print usage help for custom action and all passed actions.
    • Allow configuring null data files (done.txt and report.txt) and don't create them.
    • Color contexts and projects without an add-on, just by setting vars in the config file.
    • Place add-ons in subfolders (for easier git clone).

    Fixes:

    • Handle -h, shorthelp and help when a Fatal Error happens.
    • Properly replace date when replacing task with priority and date.
    • Fix todo_completion problem with Bash 3.1.
    • Improve code commenting/documentation.
    • Refactor code for speed/better organization.
    • Improve test coverage and test library.

    todo_completion

    • Remove add date from line completion, ie, todo.sh ls 10[tab].

用户点评

登录用户的真实使用记录，可按版本和硬件筛选
共 0 条

    还没有人点评。第一个说出真实体验的人最有价值。

    README 原文

    未翻译
    在 GitHub 打开

    todo.txt-cli

    A simple and extensible shell script for managing your todo.txt file.

    CI GitHub issues GitHub forks GitHub stars GitHub license Gitter

    gif

    Read our contributing guide if you're looking to contribute (issues/PRs/etc).

    Installation

    Download

    Download the latest stable release for use on your desktop or server.

    OS X / macOS

    brew install todo-txt

cp -n $(brew --prefix)/opt/todo-txt/todo.cfg ~/.todo.cfg

    Note: The -n flag for cp makes sure you do not overwrite an existing file.

    Linux

    From command line
    make
make install
make test

    NOTE: Makefile defaults to several default paths for installed files. Adjust to your system:

    • INSTALL_DIR: PATH for executables (default /usr/local/bin)
    • CONFIG_DIR: PATH for the todo/config configuration template (default /usr/local/etc)
    • BASH_COMPLETION: PATH for autocompletion scripts (default to /usr/local/share/bash-completion/completions)
    # Note: Showcasing config overrides for legacy locations; NOT recommended!
make install CONFIG_DIR=/etc INSTALL_DIR=/usr/bin BASH_COMPLETION=/etc/bash_completion.d
    Arch Linux

    Package todotxt in AUR

    Configuration

    No configuration is required; however, most users tweak the default settings (e.g. relocating the todo.txt directory to a subdirectory of the user's home directory, or onto a cloud drive (via the TODO_DIR variable)), modify the colors, add additional highlighting of projects, contexts, dates, and so on. A configuration template with a commented-out list of all available options is included. It is recommended to copy that template into one of the locations listed by todo.sh help on -d CONFIG_FILE, even if it is installed in the global configuration location (/etc/todo/config).

    Usage

    todo.sh [-+@aAcDfhMnNpPtTvVx] [-d todo_config] action [task_number] [task_description]

    For example, to add a todo item, you can do:

    todo.sh add "THING I NEED TO DO +project @context"

    Read about all the possible commands in the USAGE.

    Release History

    See CHANGELOG.md

    Support

    • GitHub Discussions: questions, troubleshooting, ideas and suggestions
    • GitHub Issues: report bugs and request features here (after positive feedback in the chat or discussions)

    Community

    Contributing

    We welcome all contributions. First read our Contributor Code of Conduct and then get started contributing. By participating in this project you agree to abide by its terms.

    License

    GNU General Public License v3.0 © todo.txt org

    相关项目

    同分类里 star 最高的项目
    对比全部 →
    super-productivity
    super-productivity·TypeScript

    带时间盒和时间追踪的高级待办应用，可对接 Jira、GitLab、GitHub 等平台，适合想把任务管理和工时记录合在一起的人。

    待办清单+4任务 / 待办
    23573+852.3kv20.0.02026-11-10 00:34 UTC
    taskbook
    klaudiosinani·JavaScript

    在终端里管理任务、看板和笔记的命令行工具，用纯文本文件存储数据，适合习惯键盘操作、不想离开命令行的开发者。

    命令行+4任务 / 待办
    9346+1394v0.3.02025-11-03 15:32 UTC
    taskwarrior
    GothenburgBitFactory·C++

    命令行任务管理工具，用纯文本存储待办事项，支持 GTD 工作流、标签、优先级和自定义报告，适合习惯终端操作的人高效管理任务。

    命令行任务管理+4任务 / 待办
    6159+3424v3.5.02026-11-10 00:19 UTC
    vikunja
    go-vikunja·Go

    自托管的待办与项目管理工具，数据完全归自己掌控，支持多用户协作和 API 集成，适合想摆脱 SaaS 依赖的团队。

    自托管+4任务 / 待办
    6013+20821v2.8.02026-11-10 16:04 UTC