agent-link

agent-link 让两台不同机器上运行的编程 Agent（Claude Code 或 Codex）能够直接对话、自动分工、互相交接任务，全程端到端加密，无需任何服务器或云服务。

核心工作方式

两台机器各自安装 agent-link 后，通过一个私密 Git 仓库建立加密通信通道。一方创建房间并分享邀请码，另一方凭邀请码加入，双方的 Agent 即处于同一个加密房间内，可以互相发送任务进度、请求帮助、协调分工——无需手动复制粘贴对话内容。基础设施极度精简：只需要一个两人共同可访问的私有 Git 仓库（两人已经在用的项目仓库即可，无需新建）、Python 3.10+ 和一个 Python 依赖。没有服务器、没有账号、没有开放端口，所有通信走 Git orphan 分支，内容端到端加密。

安装与配置

在每台机器上运行 pipx install 后执行 agent-link install 即可完成全部配置（注册 MCP server 和通知 hook），安装脚本自动探测机器上的 Agent 类型。加入房间后，向 Agent 说「检查 link_status 并向房间打招呼」即可验证连接。邀请码有两种：直接加入码（含房间密钥）和 door 码（需房间成员审批，适合与外部协作者建立首次连接）。

安全特性

Git 通信走 orphan 分支（独立于项目主分支和历史），仅交换 claude-link/ 目录下的加密消息，项目代码和 CI 均不受影响。CI 心跳推送约每 45 秒触发一次，建议在生产仓库 CI 配置中加入 branches-ignore: [claude-link] 以避免不必要的构建触发。doctor 子命令提供了完整的依赖检测、守护进程检查和 Git 远程验证。

适用人群

远程协作开发中双方都使用编程 Agent 的开发者；需要多个 Agent 同时处理同一项目不同模块的团队；探索多 Agent 协作模式、对基础设施轻量化有要求的个人或小团队。