Backlog.md
用 Markdown 任务和看板让人机协作的 Git 项目可审阅、可追踪。
- Star 数
- ★ 7.3k
- 最近更新
- 8 天前
- License
- MIT
- 主语言
- TypeScript
- FA 评分
- 52/100 · 缺口较多
30 秒速览
- 运行形态
- 可在哪里用
- 通用 · 跨平台Codex · Claude Code
- 费用
- 免费，无需付费服务
- 上手难度
- 低 · 几分钟可跑通
- 开始前需要
- 典型场景
- 使用 Codex 在 Git 仓库中开发功能的工程师，希望先审阅任务验收标准和实施计划，再让代理编码。
- 不适合
- 需要从局域网或 VPN 其他设备访问看板的团队
- 希望完全不用 Git 又需要分支检查、远程操作和自动提交的用户
- 不愿在任务拆分和人工审查上投入精力的团队
- 源码审查
- 52/100 · 缺口较多
这个 Agent 能做什么，适合哪些场景？
Backlog.md 是面向 Git 项目的 Markdown 原生任务管理器和终端看板工具。它把任务保存为项目内的 Markdown 文件，并通过命令行、终端 Kanban 看板、本地 Web 界面和可选 MCP 服务管理这些文件。其推荐的 AI 协作流程把工作拆分为任务规格、实施计划和代码审查三个检查点，强调一个任务对应一个会话和一个 PR。backlog browser 启动的 Web 界面仅监听本机 127.0.0.1，支持拖拽看板、任务编辑和实时同步至 Markdown 文件。它也可用作不依赖 AI 的本地任务管理器，并支持 --no-git 初始化。
运行 backlog init "项目名" 在仓库中建立 backlog，并可通过 backlog init "项目名" --no-git 建立仅文件系统项目。任务可用 backlog task create 创建、用 backlog task edit 补充描述、验收标准、评论和完成定义，并用 backlog task list、backlog search 和 backlog board 查询或展示。backlog board export 生成可分享的 Markdown 报告，带 --json 的 task list、task view、task <id> 和 search 输出稳定的机器可读 JSON。backlog browser 提供本地 Kanban 页面；backlog mcp start 则把工作流说明和项目操作暴露给已配置的 MCP 客户端。
- 使用 Codex 在 Git 仓库中开发功能的工程师，希望先审阅任务验收标准和实施计划，再让代理编码。
- 维护多人仓库的技术负责人，需要把每个小任务、依赖和里程碑作为可提交到 Git 的长期记录。
- 不使用 AI 的个人开发者，想在终端通过
backlog task create、backlog search和backlog board管理项目工作。 - 希望在本机浏览器里拖拽任务、编辑验收清单，同时让改动同步回 Markdown 文件的项目团队。
- 需要从脚本读取任务状态或搜索结果的集成开发者，可使用已文档化的
--json读命令。
如何安装或部署这个 Agent？
无需账号或凭据即可本地使用。安装任选其一：
npm i -g backlog.md
bun add -g backlog.md
brew install backlog-md或运行 nix run github:MrLesk/Backlog.md -- --version。随后在 Git 仓库中执行 backlog init "My Awesome Project"；非 Git 项目执行 backlog init "Personal Planning" --no-git。
如何使用这个 Agent？
初始化后，AI 协作可先运行 backlog instructions overview，让代理将需求拆分为带描述和验收标准的小任务；实施前要求它把计划写入指定任务并等待审阅。日常手动操作可执行：
backlog task create "Render markdown as kanban"
backlog task edit BACK-1 -d "Detailed context" --ac "Clear acceptance criteria"
backlog board需要本地网页界面时运行 backlog browser。如偏好 MCP，可为 Codex 执行 codex mcp add backlog -- backlog mcp start，或为 Claude Code 执行 claude mcp add backlog --scope user -- backlog mcp start。
这个 Agent 有哪些优点和局限？
- 任务是仓库内的普通 Markdown 文件，能与代码一起保留、审阅和提交，而非锁定在托管项目管理服务中。
- 将规格、实施计划和代码审查拆为三个明确检查点，适合在代理产出代码前控制范围和方向。
- 同时提供 CLI、终端 Kanban、可导出的 Markdown 看板和本机 Web UI，且这些界面同步同一批任务文件。
- 支持 Claude Code、Codex、Gemini CLI、Kiro 及兼容 MCP 或 CLI 的助手，并允许选择 CLI 指令或 MCP 连接方式。
- 高质量使用依赖把工作拆成可在单次会话完成的小任务，并由人类在三个检查点进行审阅。
- Web UI 仅监听 127.0.0.1，不能直接供局域网或 VPN 上的其他设备访问。
- MCP 集成需要为客户端配置服务器；手动配置时还需要在代理说明文件中加入读取工作流资源的提示。
- 无 Git 初始化会自动关闭跨分支检查、远程操作和自动提交，因此这些 Git 相关能力在文件系统模式不可用。
这个 Agent 与同类方案有什么区别？
与相关度最高的同类 agent 并排比较关键指标。
| Agent | 源码审查 | 形态 / 费用 | Star | 最近更新 | 主语言 | 完整支持的平台 |
|---|---|---|---|---|---|---|
| Backlog.md 当前 | 52 · 缺口较多 | 命令行工具免费 | ★ 7.3k | 8 天前 | TypeScript | Codex · Claude Code |
| Kangentic | 52 · 缺口较多 | 桌面应用免费 + 模型费 | ★ 140 | 今天 | TypeScript | Codex · Claude Code |
| Hazzel | 63 · 存在缺口 | 命令行工具免费 + 模型费 | ★ 26 | 8 天前 | Python | OpenAI API · Claude API |
| Agent Teams AI | 51 · 缺口较多 | 桌面应用免费 + 模型费 | ★ 2.4k | 今天 | TypeScript | Codex · Claude Code |
FollowAgents 如何评估这个 Agent？
查看各维度的扣分理由
证据显示：工具是本地优先，无遥测，但权限方面未明确最小权限原则；用户确认机制存在（如审批检查点），但未系统化；数据流透明度有限，未详细说明数据流向；敏感数据处理未明确；依赖安全未审计；外部影响（如Git操作）有配置选项但默认可能自动提交；回滚机制未明确；来源归属有作者信息但未验证。扣分原因：缺乏明确的权限最小化、数据流透明度和敏感数据处理的详细说明。
证据显示：测试覆盖广泛，包括单元测试和集成测试，但未提供测试结果；依赖可用性未明确，但提供了多种安装方式；失败消息有具体示例（如错误提示）。扣分原因：依赖可用性未验证，失败消息虽具体但未全面覆盖。
证据显示：明确面向AI代理和人类用户，场景清晰；能力边界有描述（如CLI、Web、MCP）；触发精度高（如任务ID、命令）；环境适配良好（跨平台）。扣分原因：能力边界描述虽好但未完全覆盖所有场景。
证据显示：信息架构清晰（README、CLI参考、配置文档）；安装说明详细；命名稳定（backlog命令）；示例和FAQ丰富；已知限制有提及（如Apple Silicon问题）；许可证明确（MIT）；版本和变更日志未明确；维护责任有作者信息但未验证。扣分原因：版本和变更日志缺失，维护责任未验证。
证据显示：输出可用性高（JSON、Markdown）；边际价值高（解决AI时代代码审查瓶颈）；成本效益合理（免费开源）。扣分原因：无。
证据显示：声明有部分可追溯（如功能列表），但缺乏独立验证；跨来源佐证有限（如社区工具）；事实和推断分离不明确。扣分原因：声明缺乏独立验证，跨来源佐证不足。
- 发布者身份未验证，需谨慎对待。
- 依赖安全未审计，建议检查依赖漏洞。
- 自动提交等外部操作需确认默认配置。
- 版本和变更日志缺失，影响可追溯性。
最近版本
来自该项目 GitHub Releases 的最新发布记录，说明为上游原文摘录，未经本站改写或测试。
-
发布说明摘录
- Restore native Git certificate and proxy settings, including support for private HTTPS proxies. - Fix task reads and writes in Nix packages. - Rebuild native executables and Nix packages with Bun 1.4.4 to include the upstream Brotli decoder and certificate trust fixes, and update build tools. Changes: https://github.com/MrLesk/Backlog.md/pull/1136, https://github.com/MrLesk/Backlog.md/pull/1137, https://github.com/MrLesk/Backlog.md/pull/1140在 GitHub 查看 ↗ -
发布说明摘录
Protect native Git HTTPS fetches and Nix generator downloads from compromised certificate authorities. Preserve configured Git certificate trust and authentication, and refresh build dependencies. Native Git HTTPS proxies are temporarily unsupported. Direct HTTPS and HTTP CONNECT proxies remain supported. Changes: https://github.com/MrLesk/Backlog.md/pull/1132在 GitHub 查看 ↗ -
v1.55.1 v1.55.1 — Security dependency hotfix
发布说明摘录
- Update application dependencies while preserving YAML frontmatter dates and metadata. - Update CI and publishing runtimes, certificate validation and verified Bun downloads. - Refresh Nix inputs and the Bun dependency cache. Changes: https://github.com/MrLesk/Backlog.md/pull/1130在 GitHub 查看 ↗
常见问题
它是否必须连接 AI 助手？
Git 是必需的吗？
backlog init ... --no-git 可建立仅文件系统项目；该模式会关闭跨分支检查、远程操作和自动提交。本地 Web 页面会暴露到公司网络吗？
backlog browser 的服务器监听 127.0.0.1，README 明确说明它无法从 LAN 或 VPN 上的其他设备访问。如何让 Codex 或 Claude Code 使用它？
codex mcp add backlog -- backlog mcp start，Claude Code 使用 claude mcp add backlog --scope user -- backlog mcp start。