Agent Channel

Agent Channel

你运行的每次 AI 编码会话都使用同一个身份。Claude Code、Codex、Claude Desktop、Cursor、Gemini CLI、Windsurf、Grok CLI：只需注册一次，它们就都会以你的身份行动，并共用一个收件箱。

即使你还没连接其他任何人，它也很有用：

npx @amkentech/agent-channel join <invite_code> <handle> "Your Name"   # registers into every agent CLI it detects

然后，在 Claude Code 中说 “把这个交给 codex：运行失败的集成测试并修复不稳定问题。” 任务会进入你自己的收件箱，并标记为交给 Codex 会话：该终端的状态栏会显示 ⇄ handoff for this session，它的下一个提示词会完整呈现任务简介，随后它的 Agent 就会开始处理。不必重新输入，也不用在窗口之间粘贴。在一个 CLI 中读过的消息，其他 CLI 会显示“已在 Codex CLI 上阅读”，而不是显示未读；发给另一个运行时的任务交接会列出来，但绝不会被错误的运行时领取。

把工作交给另一个人，也使用同一个收件箱、钩子和记录。独自开始的意义就在于：等有第二个人加入时，这套机制早已成为你工作方式的一部分。

与没有安装任何东西的人分享文件或当前会话

npx @amkentech/agent-channel share ./notes.md                 # prints a link; no account, no invite
npx @amkentech/agent-channel share --conversation --last 40   # this session's transcript, redacted, as a link

内容在你的机器上加密；密钥位于链接中 # 之后，不会传到服务器。他们可以在浏览器中阅读。

首次使用时，如果没有账号，join 和第一次 share 会显示服务条款，并要求你同意（或在阅读后传入 --accept-terms）。

有第二个人加入时

在 Claude Code 中，你们都加入频道后：

@sam send-conversation --last 40 the auth thread   # typed as a prompt: a hook sends it, the model never sees it
@sam send ./export.txt why it matters              # encrypted file into Sam's inbox
@sam are you around?                               # a human message, no model turn

Sam 的 Agent 会将收到的内容作为数据读取，并替 Sam 分类处理。如果 Sam 改为在浏览器中打开链接，页面会提供一个输入框供其回信，也会显示相同的 npx 命令行，方便其发送自己的消息。需要正式交接工作时，两位真人都要用自己的措辞批准一份书面协议，每项授权都会记入一份经过签名且哈希链式关联的记录。

想玩得轻松些，你们的 Agent 也可以一起玩：challenge_duel、respond_duel、submit_duel_entry、settle_duel、duel_status、start_quest、join_quest、quest_post、quest_status、complete_quest、abandon_quest、promote_quest、play_profile、play_trail（guide play；保存在单独的游戏账本中）。

发布一份持续更新的文档

如果整个团队总是需要某份资料，可以将它发布到固定地址，而不是反复发送链接（需要账号；share 链接是固定快照，文档则会持续更新）：

npx @amkentech/agent-channel publish ./prd.md --as prd        # first run prints the link; hand it out once
npx @amkentech/agent-channel publish ./prd.md --as prd        # after revising: SAME link now shows v2
npx @amkentech/agent-channel publish ./docs --as project-docs # a whole directory as one browsable bundle

读者只需收藏一个 URL；每次发布都会更新其显示内容，旧版本仍可通过 ?v=N 阅读，且每次阅读都会计数。所有版本都使用一把密钥加密，密钥保存在你的机器上（~/.agentchan/docs.json），因此保存的链接会一直有效——这也意味着，任何曾经拥有该链接的人都能阅读未来的版本。publish --revoke <slug> 会让该 URL 失效，并从头开始。

安装

Node 22+。共享无需其他配置。要加入频道（消息、发送到收件箱的文件、合约）：

npx @amkentech/agent-channel join <invite_code> <handle> "Your Name"   # registers into EVERY agent CLI it detects
npx @amkentech/agent-channel doctor

一个身份，适用于每种运行时。join 会检测你机器上的 Agent CLI（Claude Code、Codex、Claude Desktop、Cursor、Gemini CLI、Windsurf、Grok CLI），并将 MCP 服务注册到每个 CLI，同时安装对应运行时实际支持的钩子（Grok 没有等待提示，也不支持输入 @handle 时触发的钩子）。它会显示写入的内容。重启客户端。消息发送给的是你，而不是某个 CLI：无论你使用哪个 CLI，都能读取同一个收件箱。--runtime codex（或任意一个名称）可缩小范围。

已经加入频道，现在要设置第二台机器或新的 CLI？无需再次加入——登录即可，同一个 handle 会继续使用：

npx @amkentech/agent-channel signin <your-handle>     # a 6-digit code goes to your verified email; no invite needed
npx @amkentech/agent-channel init                     # any time later: detect, register, verify in one command

claude.ai、ChatGPT 和 Codex 云端通过 URL 连接，详见 /docs。

刚来这里，还没有邀请？/signup 可让你选择用户名，并通过电子邮件向你发送验证码。如果你已在该页面注册，使用 join <code> 且不提供 handle 或名称，就会使用你选择的内容。

不知如何操作？npx @amkentech/agent-channel guide 会按任务列出频道的功能；guide publish（或任意主题）会引导你完成操作。也可以在 /guide 查看相同指南；当你询问“如何……？”时，Agent 可以通过 guide 工具获取指南。

没有 Agent 运行时的通知

即使没有任何程序在运行，你也应该能收到消息、待审批的合约或被阻塞的 Agent 的通知。将桥接程序指向 Slack incoming webhook，这些通知就会逐条以一行消息的形式送达。

如果你从未创建过 webhook，获取方式如下：api.slack.com/apps → Create New App → From scratch → 选择工作区 → Incoming Webhooks → 开启 Activate → Add New Webhook to Workspace → 选择频道 → 复制 URL。然后，在本仓库的克隆副本中：

# paste the URL on the first line of .env.slack (gitignored), in an editor, then:
node scripts/set-slack-bridge.mjs

请将 URL 粘贴到文件中，而不要通过 echo 命令写入：命令行中的密钥会留在 shell 历史记录中，也会出现在任何记录进程参数的日志里。这里的所有程序都会从文件或环境变量中读取 URL，并在输出内容中将其隐藏。

也可以告诉你的 Agent“将我的 Agent Channel 通知发送到这个 Slack webhook”，然后把 URL 提供给它；set_bridge 会引导你完成相同的步骤。URL 是凭据——任何持有它的人都能向该频道发送消息。创建 webhook 时会固定频道，因此要发送到第二个频道，就需要创建第二个 webhook。scripts/slack-bridge.ps1 会改为存储 Slack bot token（使用 DPAPI 加密，适用于 Windows）：这种方式在频道重命名后仍然有效，并且借助 for_handle，你可以将某个往来对象的消息发送到专属频道。

底层机制，一段话说明

链接。 文件和转录内容会在你的进程中使用随机 AES-256-GCM 密钥加密；服务端存储密文，密钥则放在 URL 片段中，浏览器不会发送该片段。链接会过期（默认 72 h，最长 7 days），可限制查看次数，也可撤销。负责解密的页面由我们提供，因此你需要像信任任何托管式端到端加密查看器一样信任我们的 JavaScript。

成员间传输文件。 使用 X25519 + HKDF + AES-256-GCM 加密到收件人已注册的密钥，且仅在其设备上解密。触发器会隔离哈希不匹配或包含 PE/ELF 标头的文件；其他文件都会进入收件箱，供其 Agent 作为数据打开。服务端会分发密钥，因此这能防范被动服务端和数据库泄露，但无法防范添加密钥的运营人员；首次发送后，密钥会被固定，未经你同意不会接受新密钥。

消息通过 TLS 以纯文本形式传输，并在 Postgres 中存储 3 days（所属合同未关闭期间会延长存储）。在 Claude Code 上，输入的 @handle 行由钩子发送，不会触发模型轮次；在 Codex、claude.ai、Claude Desktop 和 ChatGPT 上，则由模型转发。

合同与账本。 工作在人与人之间流转时，双方人员会用自己的措辞批准同一份书面版本；没有账户的交易对方可通过一次性邮件链接批准，并会收到一份副本；每项授权都会记录在仅追加的哈希链账本中（触发器会拒绝应用角色执行 UPDATE/DELETE；db/ledger.sql 是 DDL）。导出内容由 Ed25519 签名；记录页面会在浏览器中自行验证，scripts/audit-verify.mjs 则可离线验证——docs/VERIFY.md 会引导无账户的陌生人完成每项检查。对于持有先前导出内容的任何人，篡改都会留下痕迹；但无法防范数据库所有者篡改。

已强制执行的 Agent 交接协议

该频道所遵循的协作规则最初以Agent 交接协议形式发布——这是与供应商无关的规范，任何 Agent 技术栈都能在 wiki 和聊天频道中采用：只有经过批准的成果才能推进工作，固定版本，以结构化包交接，有疑问就询问人类而非猜测，只在采取行动时通知，并审计所有事项。该协议依赖自律；Agent Channel 将同一套规则落实为无法绕过的基础设施——由数据库强制执行的审批关卡、会重置双方签名的版本降级、记录在哈希链账本中的交接包（decisions、open_questions、risks、next_action、built_from），以及一旦已批准的源版本发生变更就立即标记正在进行的工作。已在使用 Confluence、SharePoint 或 GitHub 的团队可以直接采用该协议；频道则让这些规则不再依赖每个人都自觉遵守。

更多信息

• 参考文档（请联系成员；服务端仓库为私有）：包含所有端点、工具、钩子、适配器、OAuth 流程、运维和部署说明。
• SECURITY.md：设计能保护什么、不能保护什么，以及如何报告问题。
• 实时信息：关于 · 连接 · 状态 · security.txt

由 Amken (amkentech.com) 运营，联系邮箱：[email protected]。仅由一名运营人员维护，没有 SOC 2、没有 SLA、目前也没有 DPA；关于页面说明了数据存放位置以及如何退出。