共工空间：让 AI 同事在群里接力干活

Gonggong Space: AI Agents Taking Turns in a Group Chat

Tech-Experiment #Agent#协作#Claude Code#自托管#ChatOps
🇨🇳 中文

如果团队有几台跑 Claude Code 或 Codex 的机器，共工空间要解决的问题是：怎么让群里的每个人都能把任务派给任意一台机器，同时看到实时进度——而不是各自开终端、各干各的。

Apache-2.0，10 stars，2026-09-24 创建。GitHub: https://github.com/yoqu/gonggong-space

核心设计：每台机器就是一个 Bot

每个团队成员把自己的机器注册成一个 Bot，Bot 后面跑的是本机的 Claude Code 或 Codex 实例。群聊里 @ 某个 Bot 发任务，任务就在那台机器本地执行，执行过程（Reasoning、工具调用、命令输出）实时回流到群聊。

Bot 还可以把进行中的任务移交给另一个 Bot 继续完成，形成接力——这是”共工”名字的来源。

群成员：@Mac-Mini 帮我写一个爬虫，爬一下这个页面
        ↓
Bot (Mac Mini 本机 Claude Code 接单)
        ↓ 执行中，进度实时回流群聊
        ↓ 需要更多算力时移交给 @GPU-Server
Bot (GPU Server 接力)
        ↓
任务完成，结果发回群聊

接入方式

  1. Web UI 创建 Bot → 点”绑定新机器” → 获得绑定码
  2. 队友机器上：gg login --server <url> --code <code>，然后 gg run
  3. 桌面 App 版粘贴连接链接即可

关键点：模型 API 请求从本机直接发出，服务端不经手、不持有密钥。Relay 只传消息文本，不转发模型调用。

接入协议：ACP（Agent Client Protocol），目前支持 Claude Code 和 Codex，设计上方便扩展。

群聊里能看到什么

每轮对话返回：

  • 实时输出（Reasoning、工具调用、命令输出）
  • Diff / Git 状态 / 文件树视图
  • 每轮 token 用量
  • Bot 可以发多选题让成员决策

安全：三级权限 + Sentinel

Bot 操作权限分三级：

  1. 只读：仅能读取文件和输出
  2. 工作区写入：可修改文件，但不能执行命令
  3. 完全访问：完整 Agent 能力

越权操作需 Bot 拥有者批准。开发机建议用工作区写入或完全访问；日常主力机建议别开完全访问，或用专用 VM。

零端口开放

daemon（gg run）只建出站连接，不监听入站端口。穿透家用 NAT 或企业防火墙不需要额外配置端口转发。

内置 MCP 插件

Bot 可调用 gonggong MCP 插件（工具函数）做跨设备协作：

  • 搜索聊天历史
  • 查看团队成员和运行记录
  • 向群成员提问（等待人工输入）

平台支持

平台状态
Web全功能，演示站 gg.uyoqu.com
macOS 桌面Tauri App，内置 daemon，菜单栏常驻
CLI（gg）macOS / Linux（glibc ≥2.31）/ Windows
移动端README 未提及

技术栈

  • Rust：gg daemon + gg-cast（屏幕直播流，用于一键预览 Web App / 微信小程序模拟器）
  • TypeScript：React + Vite（Web 客户端）、Fastify + PostgreSQL（服务端）、Tauri（桌面）
  • 运行要求：Node.js 24+，PostgreSQL 17（服务端），Rust 1.95+（自行编译）

已知边界

  • 安全前提：@Bot 等同于允许群成员在你机器上执行代码；生产环境建议专用机或 VM
  • 目前只支持 Claude Code 和 Codex，不支持其他 LLM
  • 仅 macOS 桌面 App，Linux 需 glibc ≥2.31，无移动端原生 App
  • 成熟度极低：10 stars，2026 年 9 月底才创建，生产稳定性未经大规模验证
  • 自托管需要 PostgreSQL 17 + Node.js 24 的部署环境

一句话说清楚

共工空间是一个自托管 ChatOps 系统：团队在群聊里共享多台机器上的 Claude Code / Codex 实例，@ 一下就能让对方机器接单执行，任务可接力传递，实时进度可见，密钥不过服务器，Relay 可自托管。仍是极早期阶段。

Apache-2.0。yoqu，2026-09-24 创建，10 stars。开源仅供学习参考。

🇬🇧 English

Gonggong Space: AI Agents Taking Turns in a Group Chat

If your team has several machines running Claude Code or Codex, gonggong-space solves one problem: how do you let everyone in the group dispatch tasks to any machine and watch the progress live — instead of each person opening their own terminal separately.

Apache-2.0, 10 stars, created 2026-09-24. GitHub: https://github.com/yoqu/gonggong-space

Core Design: Each Machine Is a Bot

Each team member registers their machine as a Bot — behind the Bot is their local Claude Code or Codex instance. Group members @ a Bot to assign a task; the task executes locally on that machine, with execution progress (reasoning, tool calls, command output) streaming back to the group chat in real time.

A Bot can also hand off an in-progress task to another Bot — the “relay” design that gives the project its name.

How to Connect

  1. Create a Bot in the Web UI → “Bind new machine” → get a bind code
  2. On the teammate’s machine: gg login --server <url> --code <code>, then gg run
  3. Desktop app: paste the connection link

Key: model API calls go from the local machine directly — the server never touches or proxies them. The Relay only carries message text.

Protocol: ACP (Agent Client Protocol), currently supports Claude Code and Codex.

What You See in Chat

Each turn returns: real-time output (reasoning, tool calls, command output), diff / git status / file tree view, per-turn token usage. Bots can also post multiple-choice polls for human decisions.

Security: Three-Level Permissions + Sentinel

Permission levels: read-only / workspace-write / full access. Escalations require Bot owner approval. Use full access on dedicated machines; avoid it on your daily driver.

Zero Open Ports

The gg run daemon makes only outbound connections — no listening port. Works through home NAT or corporate firewalls without port forwarding.

Known Limits

  • Security assumption: @ a Bot = allowing group members to execute code on your machine; use a dedicated VM in production
  • Only Claude Code and Codex supported, no other LLMs
  • macOS desktop app only; no mobile native app
  • Very early stage: 10 stars, created September 2026, not production-tested at scale
  • Self-hosting requires PostgreSQL 17 + Node.js 24

TL;DR

Gonggong-space is a self-hosted ChatOps system: your team shares Claude Code / Codex instances across multiple machines in a group chat. @-mention a Bot to dispatch tasks, tasks can relay between Bots, progress is live, keys never touch the server. Very early stage.

Apache-2.0. yoqu, created 2026-09-24, 10 stars. For reference only.

相关文章

Tech-Experiment

Doop：Paper.design 的开源替代——人和 AI Agent 实时同画布做设计
Tech-Experiment

Agent Network 调研：不做又一个 Agent 平台，只做跨厂商 Agent 的通信层
Tech-Experiment

Buzz：Block 开源的人机协作工作台，建在你自己的 Nostr relay 上

💬 评论与讨论

使用 GitHub 账号登录后发表评论

关于本站 · 免责声明

🍄 Mushroom Research Blog 是非营利、免费公开的个人科技观察博客与公众号 XStack18，不接受商业合作、不代表任何企业或机构立场，也不谋求商业利益。我们以个人视角客观中立地记录和分析 AI、Web3 等领域的最新模型发布与技术动态——不止转述新闻标题或二手信息，而是给出有独立思考的深入分析，希望帮更多人获得有价值的一手科技认知。

⚠️ 文中介绍的开源代码与模型，仅供学习交流与技术借鉴。它们大多仍处于早期阶段，有待进一步研究和验证，请勿直接用于工作或生产环境；如需采用，请先自行充分测试，并核实其许可证与安全性。
Open-source code and models featured here are shared for learning and reference only. Most are early-stage and still need further study and verification — please don't use them directly in your work or in production. Test them thoroughly and check their licenses and security first.

  1. 本站文章均为作者基于公开信息的个人研究与观点整理，不代表文中提及的任何公司、产品、模型的官方立场，未与其构成商业关联或合作关系。
  2. 科技行业信息更新极快，我们尽力保证内容准确、及时，但不对完整性、实时性做绝对保证，具体请以相关企业/项目官方公告为准。
  3. 文中引用的第三方商标、产品名称、图片、数据等版权归原权利人所有，我们会尽量注明来源；如你认为存在版权疑问或侵权，请通过下方邮箱联系我们，收到通知后会尽快核实处理（更正、加注来源或删除）。
  4. 文章内容仅为技术科普与个人观点，不构成投资、法律或其他专业建议，据此进行任何决策的后果需自行判断和承担。

📮 侵权 / 勘误 / 合作咨询：[email protected]