你的任务追踪器就是仓库里的一个文件夹。

pm 把任务、决策及其完整历史保存为 .agents/pm/ 下的普通文件。你的智能体以紧凑的 TOON 格式读取它们,在各自的分支上工作,并用 pm 自带的合并驱动合并彼此的改动。

npm install -g @unbrained/pm-cli

阅读快速入门

pm-t05d8d · Issueclosed

Allow self-isolating linked package tests without inherited PM_PATH

priority: 1 · risk: –

test_runs: 1 (last: passed)

comments: 6

resolution: Added explicit pm_context_mode=none across parser, SDK types, CLI/MCP contracts, help, completion, execution preflight, and docs; non-PM commands run only in isolated or snapshot workspaces, with PM_GLOBAL_PATH still sandboxed.

.agents/pm/issues/pm-t05d8d.toon · 8.6 kB · 文件中还有 21 个字段

.agents/pm/history/pm-t05d8d.jsonl 中共 25 条记录

这是 pm 自身追踪器中 pm-t05d8d 的真实卡片,已在 pm 2026.9.28 中修复。 TOON 格式 8.6 kB,JSON 格式 9.4 kB:分别为 2,214 和 2,290 个 token(o200k_base)。

多个智能体,多个分支,一个追踪器

当两个智能体在不同分支上修改追踪器时,git 会把两边交给 pm 的合并驱动,由它按字段而不是按行合并。

mainagent-a · feat/searchclaim pm-a1f3close pm-a1f3agent-b · fix/mergeclaim pm-b7k2close pm-b7k2agent-c · docs/sdkclaim pm-c9q4close pm-c9q4
每个条目一个文件
每个条目都是 .agents/pm/ 下的独立文件,所以在一个分支上新建的任务绝不会碰到另一个分支改过的文件。
只增不减的历史
每次改动都带着哈希链追加到条目的历史文件中,因此两个分支的记录在合并后都会保留。
理解两者的合并驱动
pm init 在初始化时注册合并驱动,pm merge install 在新克隆中修复它们。

你的智能体首先读取的内容

pm context --limit 10 用一次调用把项目状态交给智能体:哪些正在进行、哪些被阻塞、下一步做什么。这是 pm 自己的追踪器。

$ pm context --limit 10
summary:
  returned_focus:
    active_items: 18
    in_progress: 0
    open: 18
    blocked: 10
  blocked_fallback_used: false
  high_level: 10
  low_level: 4
  agenda_events: 2
  scope: "matching_items"
  active_items: 221
  open: 221
  in_progress: 0
  blocked: 60
  total_items: 2826
  closed: 2532
  canceled: 14
high_level:
  - id: "pm-doxj"
    title: "pm-cli post-v0.1 roadmap & living backlog"
    type: "Milestone"
    status: "open"
    priority: 0
    tags:
      - "backlog"
      - "context-management"
      - "living-map"
      - "pm-cli"
      - "post-v0.1"
      - "roadmap"
    updated_at: "2026-09-12T20:05:01.648Z"
由 pm 2026.9.28 于 2026年9月29日 13:20 UTC 生成。 TOON 格式 8.2 kB,JSON 格式 11.8 kB。

每个智能体遵循的流程

每项工作都按这个顺序使用五条命令。

  1. 了解现状

    查看哪些正在进行、哪些被阻塞、接下来做什么。

    pm context --limit 10
  2. 认领

    认领一个条目,避免其他智能体同时开工。

    pm claim <id>
  3. 关联证据

    附上你修改的文件和用来测试它们的命令。

    pm files <id> --add src/x.ts
    pm test <id> --add command="npm test"
  4. 验证

    运行关联的测试,结果会记录在条目上。

    pm test <id> --run
  5. 关闭

    附上证据关闭条目,然后释放你的认领。

    pm close <id> "<evidence>"
    pm release <id>

扩展包

用 pm install 为项目添加集成和工作流。

浏览全部 34 个扩展包

或者使用托管服务

同一个追踪器,与团队实时共享:在浏览器、ChatGPT 或任何 MCP 客户端中使用。