一款基于Markdown的任务管理器和看板可视化工具，专为Git仓库设计，支持人类与AI代理之间的项目协作。
一分钟了解#
Backlog.md 是一款将任何包含Git仓库的文件夹转变为独立项目看板的工具，它基于纯Markdown文件和零配置CLI构建。无论是个人开发者还是团队，都可以使用它来管理项目任务，同时与AI代理无缝协作。
核心价值：通过Markdown文件实现完全本地化的任务管理，无需云端服务，同时支持多种AI工具的集成。
快速上手#
安装难度：低 - 通过简单的命令行安装即可开始使用
# 安装命令
npm i -g backlog.md
# 或
bun add -g backlog.md
# 或
brew install backlog-md
适合我的场景吗？
- ✅ 独立开发者/小团队：需要一个完全本地化、无需云端服务的任务管理工具
- ✅ AI辅助开发：需要与Claude、Gemini等AI代理协作开发项目
- ❌ 需要复杂项目管理：如果你需要甘特图、资源分配等高级项目管理功能，可能需要更专业的项目管理工具
- ❌ 大型团队协作：虽然支持多用户，但不具备企业级项目管理软件的复杂权限和审计功能
核心能力#
1. Markdown原生任务管理 - 简化文档化流程#
- 每个任务都是独立的.md文件，存储在
backlog文件夹中 - 文件名格式为
task-<task-id> - <task-title>.md，便于识别和管理 实际价值：任务文档化无需额外步骤，与现有Git工作流无缝集成
2. AI协作能力 - 人机协作开发#
- 支持Claude Code、Gemini CLI、Codex等多种AI代理
- 通过MCP(Model Context Protocol)协议实现AI代理与任务管理的深度集成 实际价值：AI代理可以直接理解、创建和执行任务，实现自动化开发流程
3. 双界面体验 - 灵活的工作方式#
- 终端看板：
backlog board命令在终端中显示实时看板 - 现代Web界面：
backlog browser启动响应式Web UI进行可视化任务管理 实际价值：可根据工作环境和偏好选择最适合的界面，提高工作效率
4. 强大的搜索与查询能力 - 快速定位信息#
- 模糊搜索功能：可跨任务、文档和决策进行模糊搜索
- 丰富的查询命令：支持按状态、优先级、分配人等多维度筛选 实际价值：在大量任务中快速找到所需信息，提高项目可发现性
5. 任务依赖管理 - 清晰的工作流程#
- 支持任务依赖关系设置，防止循环依赖
- 可视化执行序列，清晰展示任务之间的关系 实际价值：合理安排任务优先级和执行顺序，避免工作冲突
技术栈与集成#
开发语言：TypeScript/JavaScript 主要依赖：基于Node.js构建，可通过npm、bun或Homebrew安装 集成方式：CLI工具 + Web界面 + MCP协议(AI集成)
生态与扩展#
- 插件/扩展：通过MCP协议可与多种AI代理集成，包括Claude Code、Gemini CLI、Codex等
- 集成能力：完全集成Git工作流，所有数据以Markdown格式存储在本地仓库中
维护状态#
- 开发活跃度：项目活跃开发中，支持多种安装方式和持续的AI工具集成
- 最近更新：项目包含完整的MCP集成指南，表明开发者积极跟进AI工具发展
- 社区响应：提供详细的文档和示例，表明重视用户体验
商用与许可#
许可证：MIT
- ✅ 商用：允许商业使用
- ✅ 修改：允许修改代码
- ⚠️ 限制：需包含原始许可声明和版权信息
文档与学习资源#
- 文档质量：全面，包含详细的CLI参考和集成指南
- 官方文档：GitHub仓库中包含详细的README和文档
- 示例代码：提供完整的命令行使用示例和Web界面截图