【开源】《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--historyDISPLAY_TABLE_MODE支持两种输出模式:
table:默认终端表格。markdown:Markdown 表格,适合复制到文档、Issue 或日报中。
适合的使用场景
QuickTodo 比较适合这些场景:
- 开发过程中临时记录待办事项。
- 在终端里快速维护个人任务列表。
- 用本地文件保存 Todo,不依赖账号或远程服务。
- 需要把待办列表以 Markdown 表格形式放进文档或工作记录。
它不是完整的项目管理系统,也不处理多人协作、看板、提醒和同步。它更适合承担一个明确的小角色:让 Todo 操作留在命令行里,并尽量减少打断。