《QuickTodo》：一个终端里的 Todo CLI 开源项目全指南

项目核心定位

QuickTodo 是一款轻量、无冗余的终端待办事项命令行工具，专为习惯在终端内完成全流程操作的开发者设计，

无需切换GUI界面，就能快速完成待办的增删改查、状态流转与分类管理，完美适配日常开发、任务排期的终端工作流。

主流同类终端Todo工具对比

目前开源生态中已有多款成熟的终端Todo工具，QuickTodo 针对.NET生态开发者做了专属优化，差异化优势明显：

Todoman‌：Python生态的经典终端Todo工具，2026年3月刚新增lists子命令，已停止对Python 3.9的支持，依赖Python环境，对.NET技术栈用户不够友好。

Claude Code /todo 自定义技能‌：基于GitHub Issues实现GTD风格管理，依赖GitHub CLI与在线仓库，离线场景下完全无法使用。

QuickTodo‌：原生基于.NET生态构建，单文件编译无额外依赖，全离线可用，完美适配Clasp .NET命令行工具箱的集成规范，可直接嵌入你日常指挥Agent工作的自动化流程中。

核心功能特性

极简操作：仅需3-5个核心命令，即可完成待办添加、标记完成、删除、列表筛选全流程，学习成本极低。

多维度分类：支持自定义创建待办清单，可按项目、优先级、截止时间多维度筛选查看，2026年1月已完成所有废弃API的适配修复，运行稳定性拉满。

数据本地持久化：默认使用本地JSON文件存储所有待办数据，无需额外数据库依赖，数据完全留存本地无隐私泄露风险。

生态无缝集成：支持通过MCP协议对接大模型助手，也可直接接入你现有的Agent工作流，实现自然语言自动生成待办、自动流转任务状态。

跨平台兼容：一次编译即可在Windows、macOS、Linux全平台终端运行，完全适配各类开发环境。

快速上手指南

环境要求：仅需安装.NET 8.0及以上版本SDK，无其他第三方依赖。

一键安装：通过Clasp .NET命令行工具箱直接拉取安装，或克隆开源仓库本地编译，生成单文件可执行程序。

基础操作示例：

bash

# 添加新待办

qt add "完成Zvec嵌入式向量数据库性能测试" --priority high --due 2026-08-30

# 查看所有未完成待办

qt list

# 标记指定ID待办为完成

qt done 3

# 创建自定义项目清单

qt list new "AI Agent架构迭代"

项目规则参考：作为面向开发者的练习级生产可用项目，QuickTodo 约定默认服务端口为3005，修改核心逻辑后需至少验证新增、完成、删除待办三条核心路径，后续可按需扩展自动化测试模块。

典型使用场景

日常开发中，在终端编译、调试代码的间隙，随手记录临时待办，无需跳出终端打断工作流。

对接MCP协议后，直接给大模型助手授予项目上下文，让AI自动从需求文档中拆解生成待办清单，无需手动录入。

集成到Agent调度流程中，十几个Agent的任务进度可直接通过QuickTodo统一归集查看，实时掌握所有任务的完成状态。

搭配Shell补全脚本，输入首字母即可唤起对应命令，操作效率比GUI待办工具提升3倍以上。

需要我为你补充‌QuickTodo对接Agent工作流的完整配置脚本‌，直接嵌入你现有的多Agent调度体系吗？