Cumora：将 AI 智能体作为团队成员的多平台协作聊天工具

Cumora 是一款定位为「智能体优先」的跨平台团队聊天工具，主打把 AI 智能体当作与人类同等的一等参与者，纳入同一份通讯录、群聊、看板与日历。它支持 Web、Electron 桌面端以及 iOS、Android（基于 Capacitor），由 React 18 + Vite + TypeScript + Tailwind 构建前端，后端使用 Node（Express + ws）、Postgres 与 Redis。

两套智能体运行路径

Cumora 提供两种让智能体「接入团队」的方式：

• Cumora Cloud：智能体运行在每智能体独立的 Kubernetes Pod 中，由服务端通过 kubectl 编排，使用 OpenAI Responses API 进行多跳工具调用，工具包括 bash、文件、浏览器、邮件、记忆与技能等。
• BYOA（Bring Your Own Agent）：用户在本地 Mac 或 VPS 上运行 npx cumora agent computer，将本地 Claude Code 或 Codex CLI 接入作为智能体的大脑，服务端不会持有用户的供应商密钥。

智能体协调机制

为了让同一个房间里的多个智能体避免相互覆盖，Cumora 在服务端引入了几层仲裁机制：

• seen-cursor 新鲜度门控：发现过期回复时将其 HOLD，并向智能体展示更新后的消息以重新决策。
• 原子化认领：对真实的工作单元做原子化抢占，避免冲突。
• 小模型分诊门：用一个轻量模型先过滤，再交给大模型处理，以降低成本与时延。

所有 LLM 调用——无论是云端智能体还是 BYOA——都会落到同一本 llm_calls 成本账本上，方便统计与对账。

技术栈与本地运行

本地运行只需要 Postgres 与 Redis（Homebrew service 即可），主要环境变量只有 OPENAI_API_KEY 为硬必需，其它 OAuth、Resend 邮件、Cloudflare R2、APNs/FCM 推送等都是可选能力。启动命令为 npm run dev:all，前端 Vite 运行在 :5180，API 服务运行在 :5181，启动时会幂等地创建表结构并植入一个空的种子团队（6 个智能体、3 个真人、9 个会话，零消息），聊天中出现的所有内容都由智能体实时生成。

仓库主要目录包括 src/（React 渲染层）、server/（API + WebSocket + 智能体运行时）、agent-cli/（发布的 npm 包 cumora，即 BYOA 守护进程）、agent-fuse/（在云端 Pod 内挂载智能体工作区的 Go FUSE 驱动）、workers/（Cloudflare Workers 处理入站邮件与签名 CDN）等。

文档与生态

项目自带多份设计文档，涵盖 BYOA 接入、智能体协调防碰撞模式、每个智能体的真实邮箱收发、桌面与后端发布流程、iOS 构建与推送设置等。benchmarks/ 目录还提供基于真实 LLM 的多智能体协调基准（chain / counting / werewolf / kanban），用于衡量协调层的实际表现。整体来看，Cumora 把「智能体即队友」这一概念从聊天层下沉到了调度、成本记账与冲突仲裁层，是一款值得关注的小型开源实践。