简体中文 | English
Team Cross 是 macOS 上围绕 Coding Agent 会话展开的开源本地协作工具。从已有的 Codex、Claude Code Session 中选择并预览要分享的材料，邀请同事和他们的 Agent 一起阅读、引用和讨论；需要一起动手时，再创建新的原生协作会话，由空间成员共同阅读，并按会话交接输入。
继续使用熟悉的终端和原生客户端，也可以打开 WebGUI 查看共同上下文。协作空间与共享执行托管在发起者的 Mac，个人 Agent 通过 MCP 按需参与，各自保留自己的会话、模型与本地上下文。
交互演示 · 下载 v0.2.6 正式版 · 使用指南 · 工程文档
“能帮我看一下这个 Session 吗？”可以先从一段调查开始，也可以请同事接着处理手头的工作。Team Cross 支持三人及以上参与同一个空间，每个人有独立身份，可以贡献多份材料。
你的 Session，可以是你的提问，也可以是你的回复。 在代码审查或排查 Bug 时，同事可以沿着会话查看提供过什么背景、检查过哪些代码、考虑过哪些边界情况，以及哪些结论已经得到验证。
| 你想做什么 | 如何参与 |
|---|---|
| 看一眼，提意见 | 阅读同事选择公开的内容，在原文旁批注与回复，无需取得输入权 |
| 带来我的调查 | 从自己的会话中选一段，预览后发布到同一空间，讨论引用具体版本 |
| 带上我的 Agent | 让个人 Codex 或 Claude Code 通过 MCP 按需读取材料、核对依据并回复讨论 |
| 接过输入继续 | 明确取得该会话输入权后，在对应原生客户端操作共享会话，执行留在发起者主机 |
比如，一个前端埋点的问题，可能涉及后端如何下发 trace ID、客户端 Native 如何处理事件、跨端容器的改动，以及数据落仓的要求，还需要理解产品希望衡量什么。开始调查的人，可能只掌握其中一部分背景。你可以先分享已经开展调查的会话，后端和客户端同事补充各自的材料，产品同事提供业务背景；每个人再让自己的 Agent 按需阅读、核对，并把新的发现带回讨论。
产品同事借助 AI 实现一个小功能，需要工程师检查实现和影响范围，或其他业务团队需要理解本团队代码库中的一段逻辑，也可以从分享会话材料开始。需要进一步操作时，再创建协作会话并交接输入权。
当前正式版本为 v0.2.6。以下方式选择一种：
| 方式 | 安装与打开 |
|---|---|
| 下载 App | 下载 Apple Silicon DMG，将 Team Cross.app 拖入“应用程序”并打开 |
| Homebrew App | brew install --cask YTwsy/teamcross/team-cross，打开 App 或运行 teamcross |
| Homebrew CLI | brew install YTwsy/teamcross/teamcross，然后运行 teamcross |
安装后运行不需要 Go、Node 或 pnpm。App 自带 CLI 和本地服务；DMG 用户可从菜单栏“命令行工具…”安装命令入口。阅读已发布材料无需先安装 Codex 或准备本地仓库。
当前安装包使用 ad-hoc 签名，未经 Developer ID 签名或 Apple 公证。首次打开若受到系统提示，先尝试打开 App，再按 Apple 的说明 在“系统设置 → 隐私与安全性”中允许打开。
升级前退出正在运行的 Team Cross，通过原渠道更新。安装程序保留协作数据与工作目录，但 v0.2.6 不加载或迁移旧 schema:2 材料，旧数据仍保留在磁盘。稳定版与 RC Homebrew 渠道分别维护，普通升级不会自动切换渠道；更换安装方式前应先卸载原渠道。
完整的切换步骤见 安装与升级，版本变化、CLI 下载、校验值和来源信息见 Release。
打开菜单栏 App，或在终端运行：
teamcrossteamcross 与 teamcross serve 都会启动或复用本地服务，打开浏览器后返回终端。发起者需保持 Team Cross 运行，供同事连接；关闭浏览器不会停止服务。
菜单栏和 WebGUI 默认跟随这台 Mac 的首选语言：中文显示简体中文，其他语言显示英文。可从菜单栏“语言”或 WebGUI“设置与连接 → 界面语言”选择跟随系统、简体中文或 English；选择会同时作用于本机两套界面。会话原文、用户输入和协议字段不会被翻译。
- 点击“发起协作 → 先分享讨论”，搜索并选中自己的来源会话。
- 在会话正文旁选择“从这轮开始”和“到这轮结束”，点击“预览分享内容”，核对选中范围的正文、工具过程和导出说明后创建只读空间。
- 选择局域网或 Tailcat，生成邀请链接并发给同事。同一链接可供多位同事加入，大家都可以发布自己的材料、批注和回复。
只读分享不创建原生 fork，也不开放执行目录。后续对话不会自动公开，更新材料需要作者主动预览并发布新版本；已有批注和引用仍指向当时的版本。撤回可以停止后续读取，已经被读到的内容无法收回。
材料支持 Markdown、代码高亮、原文旁批注与固定版本引用。长工具输出按需展开，对话目录可以读取并定位尚未加载的轮次，阅读时可查看材料来源与公开范围。详见 分享与审阅 和 阅读与批注。
- 在已有空间选择“新增协作会话”，或从首页选择“发起协作 → 直接一起执行”。
- 确认来源会话、执行目录和权限模式，创建新的原生协作 fork。可以沿用原目录，也可以从选定
HEAD创建新 worktree。 - 向指定成员明确交接该会话输入后，对方使用对应的原生 TUI 或 Codex 专用 Desktop 接着做，完成后交还输入。
创建协作会话保留原空间的链接、成员、材料和讨论。全部空间成员均可读取其完整历史与工作目录，实际写入需要该会话输入权。多人可以同时阅读讨论，不同会话可以分别交给不同成员，同一会话同时只有一位输入者。
原目录模式保留 Git 分支、暂存区和已有文件；新 worktree 从确认的 HEAD 检出，不复制未提交内容。结束共享保留会话、代码与工作目录，之后可以恢复同一个 fork。详见 执行与目录选择 和 结束与恢复。
先安装 Team Cross，再打开 teamcross:// 邀请链接，或在“加入协作”中粘贴邀请码。核对协作名、主机和访问范围后加入。终端也可以运行：
teamcross join '收到的邀请码或完整邀请链接'关闭或重置邀请链接不会移除已有成员；发起者可以单独撤销某位成员的访问。临时断线不等于离开，重连与退出规则见 邀请与加入。
开发构建还提供 ChatGPT for Mac 本机插件：在本机 Work/Codex 中打开完整的现有 WebGUI；空间、资源库、批注和会话配对共用同一套页面，并可将明确选定的材料带回当前会话。插件经 stdio 接入本机 Core；正式分发前需完成对应版本的桌面成品验收。
WebGUI 是可选入口。个人 Codex TUI/Desktop 或 Claude Code TUI 可以通过 Team Cross MCP，按你的指令发布材料、读取上下文并参与讨论；终端也提供对应 CLI 入口。
在“设置与连接”中选择 Codex 或 Claude Code，点击“接入本机”，已有客户端重新连接 MCP 或重新打开。也可以使用页面给出的完整路径执行配置命令，详见 个人 Agent 与 MCP。
接入后，可以这样提出请求：
“列出这个空间的材料，阅读这条批注引用的版本，结合我们的项目约定核对一下，再回复到原批注。”
个人辅助 Agent 的会话与模型调用留在各自本机；发往共享会话的任务在发起者主机执行。保存批注不会自动向共享 Agent 发送任务，需要你明确让它读取和处理。
直接操作共享会话时，原生运行时已经提供当前空间的材料与批注工具，无需另外安装个人辅助 MCP。具体入口和操作差异见 使用指南。
一个人工作时，这些上下文也能继续发挥作用。通过“资源库”找回此前分享或参与讨论的 Session 材料、批注和执行上下文，让当前 Agent 按需阅读，核对不同 Session 中积累的线索与决定，接上自己此前已经开始的工作。
在资源库中选择需要的内容，通过“交给 Agent”选择已配对的接收会话；首次粘贴一次配对提示，核验接收能力后即可反复发送。尚未接通投递时，也可复制本机读取提示。菜单栏左键或 Control + Option + T 打开协作速览，在“当前协作”和“资源速览”间切换。详见 资源库与速览。
团队已经有自己的工作区、终端和 Agent 配置。请同事帮忙看一次问题，应当能接在现有工作之后；Team Cross 从已有 Session 和会话记录入手，让大家继续使用熟悉的工具，WebGUI 作为可选入口。
集中式云端协作需要评估代码与业务上下文的数据要求，内网部署又会带来额外的配置和维护。Team Cross 将协作空间和共享执行托管在发起者的 Mac 上：同一局域网内直接连接；有跨网络需求时，再根据团队允许的网络条件选择实验性的 Tailcat。参与者需要安装 Team Cross，无需额外注册 Team Cross 账号，也无需先集中部署一套协作平台。
这里的本机托管指协作服务与执行位置；各自的 Agent 仍按所选 Provider 的配置进行模型调用。
| 项目 | 范围 |
|---|---|
| 系统与分发 | Apple Silicon、macOS 14+；App / CLI；暂无 Intel 产物、自动更新或登录自启 |
| Codex 直接操作 | 原生 TUI、专用于协作的 Codex Desktop；个人 Desktop 与专用窗口用途不同 |
| Claude Code 直接操作 | 原生 TUI，实验性；补充、中断、审批与模型选择在原生 TUI 中处理，未接入 Claude Desktop |
| 个人 Agent 辅助 | Codex TUI/Desktop、Claude Code TUI 通过 MCP 参与，可辅助不同 Provider 的协作 |
| 局域网 | 参与者处于可互访的同一局域网，发起者保持服务运行 |
| Tailcat | 实验性；无需 Tailscale 账户或系统 TUN，可直连或经 DERP 中继，质量取决于网络与所用 DERP |
| 空间与会话 | 一个空间可有多个协作会话，全体成员共同阅读，输入权和暂停恢复独立；不同 worktree 可并行 |
| 执行目录 | 普通 Git 仓库；沿用原目录或创建新 worktree，暂不支持含 submodule 的仓库 |
| 模型与推理强度 | 创建时继承原生来源，后续遵循当前输入者在原生客户端中的选择；产品不固定模型 |
共同执行默认采用受限模式。显式选择信任模式会沿用发起者的原生配置、工具和权限，工具可能访问工作目录之外的数据；模式创建后固定，恢复时沿用。具体差异见 协作模式。
局域网与 Tailcat 由用户明确选择，不自动切换。邀请包含访问凭据，应按秘密保管。原生客户端接口仍可能随版本变化，Desktop 的其他全局功能不在兼容承诺中。
已记录的同机验证不代表两台 Mac、跨网络 Tailcat 或持续 DERP 中继已完成验收；实际版本与覆盖范围见 验收导航。
真实工作经常需要回头：新的发现可能让我们重新确认需求是否理解错了，补查此前遗漏的历史约束，甚至重新判断当前方向是否值得继续。什么时候该回头、该调整，仍然离不开人的经验和判断。
了解背景的同事及时看一眼，就可能让调查少走一段弯路。Team Cross 关注这些判断能否在需要的时候发生，让同事带着自己的工具和 Agent 加入正在进行的工作。减少人工介入的次数，本身并不足以说明研发得到了提效。
我们也在探索让托管机器上的 Agent 在需要人判断时自主发出邀请。这仍是产品方向；当前由用户明确发起分享、创建协作会话与交接输入。
从源码开发需要 Go 1.27.1+、Node 24+ 和 pnpm；构建 App 还需要 macOS Command Line Tools / Swift。
pnpm install
make build
./bin/teamcross serve- 使用指南：安装升级、CLI / MCP、阅读批注、输入交接与恢复。
- 开发与构建：环境准备、源码调试、本地安装包与验证入口。
- Agent Wiki 索引：当前产品决策、架构、协议与验证要求；参与开发先读 AGENTS.md。