ARTICLE · INTELLIGENCE

战地情报 · 详情页

来自尧图项目组的一线实战观察与深度解析

【开源】《QuickTodo》一个终端里的 Todo CLI

【开源】《QuickTodo》一个终端里的 Todo CLI

【开源】《QuickTodo》一个终端里的 Todo CLI

QuickTodo 是一个用 Go 编写的终端 Todo 工具,默认命令名是qtd。它的用途很直接:在命令行里快速添加、查看、修改、完成和删除待办事项。

如果你的日常工作主要在终端里完成,qtd可以把临时任务记录、任务状态更新和待办列表查看都放在当前工作流里,不需要切换到单独的应用。

安装

GitHub 仓库地址:https://github.com/DoYoungDo/QuickTodo

预编译二进制下载地址:https://github.com/DoYoungDo/QuickTodo/releases

如果从源码构建,需要先安装 Go。当前项目的go.mod声明版本为 Go 1.26。

gitclone https://github.com/DoYoungDo/QuickTodo.gitcdQuickTodo go build-oqtd.

构建完成后,可以直接在当前目录运行:

./qtd--version./qtd list

如果希望在任意目录使用qtd,可以把二进制放到 PATH 中的目录。例如:

mvqtd /usr/local/bin/qtd qtd--version

如果通过 GitHub Release 页面下载预编译二进制,可以选择对应系统和架构的文件,改名为qtd后放入 PATH。

使用效果


基本使用

查看帮助信息:

qtd-hqtd--help

如果只想查看某个子命令的用法,可以在子命令后使用-h:

qtdadd-hqtd mod-hqtd list-hqtd conf-h

帮助信息会列出当前命令支持的参数、选项和子命令。比如list -h可以查看过滤内容、忽略大小写、ID 范围等选项;mod -h可以查看追加、插入、完成状态和优先级相关选项。

添加一个待办事项:

qtdadd"write README"

查看待办列表:

qtd list

根命令没有参数时,默认等价于list:

qtd

直接传入文本时,默认等价于add:

qtd"review pull request"

把某个待办标记为完成:

qtddone0

修改待办内容:

qtd mod0"update README"

删除待办:

qtdrm1

移动待办顺序:

qtdmv20

清空所有待办:

qtdclear

如果不需要确认提示,可以使用:

qtdclear-f

常用操作

添加时直接标记为完成:

qtdadd"ship release"-d

只查看已完成事项:

qtd list-d

按内容过滤:

qtd list-f"readme"

忽略大小写过滤:

qtd list-f"readme"-i

按 ID 范围查看:

qtd list-b0-e3

追加内容:

qtd mod0" - urgent"--append

在原内容前插入文本:

qtd mod0"NOW: "--insert

设置优先级:

qtd mod0-p2

配置

QuickTodo 内置本地 JSON 仓储,配置也保存在本地。查看配置:

qtd conf qtd conf list

修改配置:

qtd confsetDISPLAY_TABLE_MODE markdown

删除配置:

qtd conf del DISPLAY_TABLE_MODE

查看配置历史:

qtd conf list--history

DISPLAY_TABLE_MODE支持两种输出模式:

  • table:默认终端表格。
  • markdown:Markdown 表格,适合复制到文档、Issue 或日报中。

适合的使用场景

QuickTodo 比较适合这些场景:

  • 开发过程中临时记录待办事项。
  • 在终端里快速维护个人任务列表。
  • 用本地文件保存 Todo,不依赖账号或远程服务。
  • 需要把待办列表以 Markdown 表格形式放进文档或工作记录。

它不是完整的项目管理系统,也不处理多人协作、看板、提醒和同步。它更适合承担一个明确的小角色:让 Todo 操作留在命令行里,并尽量减少打断。

RELATED READING

延伸阅读

更多一线实战笔记与深度复盘,助您持续精进