passalong

passalong

将工作交给 AI 编码 Agent，再获取它们完成的内容及检查方式。

只需编写一次任务、错误或已完成的更改。接手的 Agent 一开始就知道完成标准和已有决策，会在执行过程中汇报进度，并在交付时附上说明，为你提出的每项要求提供证据，由你批准或退回。每项工作由一个 Agent 负责，所有人都能看到各自负责的事项。适用于 Claude Code、Codex、ChatGPT、Claude，以及任何支持 MCP 或 HTTP 的工具。请访问 passalong.dev。

npm i -g passalong
passalong setup      # installs the Claude Code capture skill + registers the MCP server
passalong login      # optional: sync guides across machines and get share links
codex mcp add passalong -- passalong mcp   # Codex: the same MCP server

工作流程

1. 完成工作：在 Claude Code（或任何 Agent）中完成工作。说 “pass this along”、运行 /passalong-capture，或自行运行 passalong share。
2. 精简并发布。 草稿会在编辑器中打开。保存后即可获得一个短 ID 和链接。
3. 在另一端拉取。 在目标仓库中运行 passalong pull <id>，或将链接粘贴给任何使用 Passalong MCP 服务的 Agent。指南会进入其上下文；Agent 会根据标记为 ASSUMES: 的部分调整并实现。
4. 完成交接。 成功接收后运行 passalong done <id>。如果某项指南被反复拉取，则运行 passalong promote <id>。

命令

passalong share [file] [--to team[/handle]]  publish a guide → id + link, Ready; --to addresses it
passalong pull <id|link>      print a guide; --save also writes ./.passalong/<id>.md (git-ignored)
passalong inbox               guides handed to you that you have not pulled yet
passalong board               waiting on you, in flight, landed, worth keeping
passalong activity [--all]    what happened while you were away; clears unless --all
passalong list [query]        your guides and your teams'
passalong open <id> [--print] view a guide in the browser (or the terminal)
passalong hub                 open your synced guides in the browser
passalong archive <id>        off your board and out of the free tier's count (was `done`)
passalong promote <id>        deprecated: mark promoted
passalong rm <id>             delete a guide locally and from sync
passalong export [dir]        dump every guide as plain markdown
passalong login               sign in from the browser
passalong login --with-token  read a token from stdin instead (CI, scripts)
passalong login --new         add another account to this machine
passalong accounts            the accounts signed in here, and which is the default
passalong use <name>          make one of them the default
passalong logout [name]       forget one of them (default: the current one)
passalong me [--handle H] [--name N] [--email E]   who you are to teammates
passalong team                current team and its members
passalong team create <name>  start a team (you become its owner)
passalong team invite [email] make an invite link (mailed when an email is given)
passalong team join <link>    accept an invite
passalong team use <slug>     switch the current team
passalong setup               install the Claude Code capture skill + register the MCP server
passalong mcp                 run the MCP server over stdio
passalong version             print the installed version (also -v, --version)

团队

团队是共享的基本单位。成员可以查找、拉取团队共享的所有指南，并将其标记为已处理；指南也可以交给某个人，由其在收件箱中查看（如果服务已配置邮件，还会通过邮件收到）。

passalong me --handle lukman            # how teammates address you
passalong team create Khaime            # you become owner; "khaime" is now current
passalong team invite [email protected]   # or no email: prints a link to send yourself
passalong team join <link>              # on Ada's machine — or she just opens the link
passalong share --to khaime/ada         # hand this guide to Ada
passalong inbox                         # on Ada's side: what was handed to you
passalong activity                      # back on your side: it landed, and who pulled it

所有指南，无论类型如何，都遵循相同的流程：共享后即为 Ready（或是状态为 status: draft 的草稿，直到有人运行 passalong ready <id>）；接手的人运行 passalong take <id> 后负责处理，提交指南并附上证据，再由其他人批准，或说明原因后退回（运行 passalong approve / passalong reject）。

使用邮箱和密码登录中心，并在其中为命令行和 MCP 服务创建 API 令牌。令牌可命名、可撤销，且只会显示一次。密码绝不会接触终端。无参数运行 passalong login 仍会创建账户，无需上述信息；之后可添加邮箱和密码，以便从浏览器登录和找回账户。

并非所有收到指南的人都会负责实现。每个指南页面都有一个 Verify 视图（?view=verify），优先显示 Problem、Verification 和 Gotchas，并将实现部分折叠起来，供测试人员或其他负责检查而非实现工作的人使用。邀请须在浏览器中接受，因此队友无需使用终端即可加入团队。

passalong activity 展示交接的另一部分：有人拉取你交出的指南、将其标记为已处理，或接受邀请时，它都会告知你。发给个人的交接也会通过邮件发送；团队范围的共享则不会，因为没人被明确指定的邮件最容易被过滤掉。反复被拉取的指南会收到提示，让你将其升级为团队维护的少量参考资料之一。

MCP

passalong setup 会将服务注册到 Claude Code。对于其他客户端，请通过标准输入输出运行 passalong mcp。

工具：search_guides、inbox、get_guide、publish_guide（带 to）、guide_template、set_guide_status。

指南采用纯 Markdown 格式

指南是带有 frontmatter 的纯 Markdown，保存在服务端；你的机器上不会堆积文件。需要文件时再获取：运行 passalong pull <id> --save，或运行 passalong export 导出所有指南。

运行 passalong login 前，设置 PASSALONG_API=https://your-host，即可指向可自托管的服务。

多个账户

一台机器可以登录多个账户，例如工作账户和个人账户。 passalong login --new 会在第一个账户旁添加另一个账户，passalong accounts 会列出这些账户，而 passalong use <name> 会设置终端用户的默认账户。

Agent 没有终端可供询问，因此如果有两个或更多账户，且没有指定使用哪个账户，就会拒绝操作并提示询问你。它会用通俗的语言向你提问，你作出回答后，它会调用 use_account 并传入账户名称。此设置仅在当前会话中有效，不会更改磁盘上的任何内容。在 Shell 中， --as <name> 或 PASSALONG_ACCOUNT=<name> 可为单条命令指定相同设置。你所在的团队（passalong team use）属于账户，而非机器。