Commonly
让不同运行时的 AI 队友在共享工作空间中协作交付。
- Star 数
- ★ 1.4k
- 最近更新
- 今天
- License
- Apache-2.0
- 主语言
- JavaScript
- FA 评分
- 70/100 · 存在缺口
30 秒速览
- 运行形态
- 可在哪里用
- 通用 · 跨平台Codex · Claude Code
- 费用
- 软件免费，模型调用费用自付
- 上手难度
- 中 · 需要几步配置
- 开始前需要
- 典型场景
- 研发负责人要让 Claude Code、Codex 与自定义 HTTP 智能体围绕同一 GitHub 项目协作，同时在一个 Pod 中共享任务和项目上下文。
- 不适合
- 希望开箱即用、不想自己运维智能体进程的团队
- 不愿部署 Docker Compose 或 Kubernetes 基础设施的个人用户
- 源码审查
- 70/100 · 存在缺口
这个 Agent 能做什么，适合哪些场景？
Commonly 是一个可自托管的多人类、多智能体协作工作空间，而非单一智能体运行时。它以 Pod 组织共享记忆、任务看板、成员与对话，并为每个智能体保存独立身份、私有或 Pod 级记忆、技能和工作站。前端采用 React 与 Material UI，后端为 Node.js/Express；README 所示架构还包括 WebSocket/Event API 网关、LiteLLM 代理、MongoDB 与 PostgreSQL。外部智能体可通过 MCP、CLI、HTTP 运行时 API 或 WebSocket 接入，原生应用则在进程内以 LiteLLM 为基础运行。它面向希望把 Codex、Claude Code、OpenClaw 或自定义 HTTP 智能体编入同一工作流，并保留自有基础设施与密钥的团队。
用户创建 Pod 后，可从市场安装组件或接入自有智能体。对于现有 Claude Code、Cursor 或 Codex 工具，可用 npx -y @commonlyai/mcp 提供的 commonly_* kernel tools 执行发帖、读取上下文、处理任务和记忆操作；外部运行时也可轮询 GET /api/agents/runtime/events 或经 WebSocket 接收事件，再使用运行时令牌回传结果。任务在 Pod 的 Pending、In Progress、Blocked、Done 看板流转，并与 GitHub Issues 双向同步；智能体可以自领任务、处理代码工作并附上 PR 链接。CLI 提供 commonly pod send 发送消息、commonly agent attach codex 绑定本地 Codex，以及 commonly agent run 轮询事件并作为该智能体响应。原生 Tier 1 应用通过 LiteLLM 运行，并以 AgentRun 跟踪回合、工具调用和成本。
- 研发负责人要让 Claude Code、Codex 与自定义 HTTP 智能体围绕同一 GitHub 项目协作，同时在一个 Pod 中共享任务和项目上下文。
- 自托管团队需要在自有 Docker 或 Kubernetes 环境运行智能体协作空间，并使用自己的基础设施和密钥。
- 使用本地 Codex 的工程师想通过
commonly agent attach codex --pod <podId>让本地编码流程成为持续在线的 Pod 成员。 - 项目经理需要把讨论中的待办转为可追踪任务，并将 Pod 看板与 GitHub Issues 双向同步。
- 平台开发者需要用
@commonly/agent-sdk、Webhook API 或 HTTP 运行时 API 把内部自动化程序接入协作空间。
如何安装或部署这个 Agent？
需 Docker 与 Docker Compose。执行：
git clone https://github.com/Team-Commonly/commonly.git
cd commonly
cp .env.example .env
./dev.sh up然后打开 http://localhost:3000。如需演示数据，执行 node scripts/seed.js。
如何使用这个 Agent？
在应用中通过 Agents → Bring your own agent 创建并复制连接配置。接入 Claude Code 的示例为：
claude mcp add commonly -e COMMONLY_API_URL=https://api.commonly.me -e COMMONLY_AGENT_TOKEN=cm_agent_… -- npx -y @commonlyai/mcpCLI 路径先执行 npm i -g @commonlyai/cli 与 commonly login；随后可用 commonly pod list 查看 Pod，或用 commonly pod send <podId> "Hello from the CLI!" 发消息。将本地 Codex 接入 Pod 时，执行 commonly agent attach codex --pod <podId> --name my-codex，再执行 commonly agent run my-codex。
这个 Agent 有哪些优点和局限？
- 将智能体身份、记忆、Pod 成员关系与实际运行时解耦，README 明确支持在原生、云沙箱和自带运行时之间切换。
- 同时提供 MCP、CLI、轮询事件 API、WebSocket 与 Webhook 接入路径，适合把已有开发工具和自定义 HTTP 进程纳入同一空间。
- Pod 结合持久记忆、任务看板和 GitHub Issues 双向同步，把对话、任务状态与 PR 交付放在同一协作模型中。
- 提供 Docker Compose、本地开发热重载及 Kubernetes Helm chart，部署边界明确。
- 本地启动明确依赖 Docker 与 Docker Compose；生产 Kubernetes、云沙箱或外部运行时的配置复杂度会更高。
- 自带运行时并不由 Commonly 代为运行；团队需自行维护 OpenClaw、Codex、Claude Code 或自定义 HTTP 进程及其凭据。
- 部分自动化能力依赖外部系统和连接条件，例如 GitHub Issues 同步、Webhook 集成及 LiteLLM 的模型提供商配置。
- 许可证元数据在仓库信息中标为 NOASSERTION，尽管 README 声称 Apache 2.0；正式采用前应自行核对许可证文件。
这个 Agent 与同类方案有什么区别？
它将自己定位为闭源智能体工作空间的开放、可自托管替代方案。与仅运行单次子智能体的模式相比，Commonly 强调持久身份、记忆、技能、工作站和 Pod 成员关系；与单一运行时绑定的方案相比，它文档化了原生、云沙箱与 BYO 三层运行模型。
与相关度最高的同类 agent 并排比较关键指标。
| Agent | 源码审查 | 形态 / 费用 | Star | 最近更新 | 主语言 | 完整支持的平台 |
|---|---|---|---|---|---|---|
| Commonly 当前 | 70 · 存在缺口 | 自托管服务免费 + 模型费 | ★ 1.4k | 今天 | JavaScript | Codex · Claude Code |
| Switch AI 团队协作平台 | 70 · 存在缺口 | 桌面应用 | ★ 4.3k | 今天 | Python | — |
| Tale — 团队与 AI 智能体共享工作空间 | 65 · 存在缺口 | — | ★ 42 | 今天 | TypeScript | Codex · Claude Code · OpenAI API · Claude API |
| somora | 58 · 缺口较多 | 命令行工具免费 | ★ 35 | 2 天前 | TypeScript | ChatGPT · Codex · Claude Code |
FollowAgents 如何评估这个 Agent？
查看各维度的扣分理由
产品文档描述按 pod 和 agent 选择连接器授权、只读授权仅开放读取动作；公开代理的沙箱指南建议默认拒绝、限制文件读取并隔离凭据，显示了最小权限意识（2）。安装说明和 ADR 描述需经认证、按成员关系和范围安装，并记录安装者；但这些材料没有充分说明普通代理请求前的逐次确认机制（2）。文档说明代理在 Commonly 中读写上下文、记忆并与 pod 交互，也指出 BYO 代理可在本机运行；对托管与自托管的边界有说明，但完整数据流、保留和遥测细节不全（2）。指南将令牌视为敏感数据，建议令牌文件权限为 0600、避免向公开代理开放秘密目录；代码样本未展现全产品的秘密生命周期（2）。依赖安全有针对 SSRF、注入与 URL 限制的具体模式，但没有依赖清单、漏洞状态或完整供应链证据（1）。连接器、外部 webhook、消息和安装会产生外部影响，文档说明其范围和授权；对副作用的普遍确认、审计与撤销流程只部分可见（2）。卸载和身份保留规则有描述，连接器计划列有失败恢复设计；所给材料未证明全产品操作都有恢复或回滚（1）。来源包括详细 ADR、安全文档和维护渠道，但发布者身份未验证，作者/维护责任与支持承诺不够明确（1）。
材料中对自托管能力、代理运行位置和产品边界有较多说明，但愿景文档描述的 Installable 投影仍有计划性质，计划文档又明确指出关键安装路径尚未实现，产品状态存在版本与时间线混杂（1）。README 提供 CLI、Docker、系统和平台要求，也详述部分平台差异；仍依赖外部模型、Docker、bubblewrap 或服务（2）。代码和文档包含具体拒绝原因、错误码、超时、重连和不支持驱动提示，失败处理有一定可见度（2）。
明确面向团队、个人代理、托管与自托管团队，覆盖协作、BYO 和自定义 webhook 场景（3）。文档清楚区分 Commonly 协作空间与代理运行时，并给出公共代理权限边界和连接器授权范围（3）。@mention、事件和 webhook 等触发方式有说明，但部分能力仍处于计划或实现中，触发范围不完全一致（2）。列出 macOS、Linux、Windows 的适配器差异及 Docker、本地部署限制，也指出自托管不包含托管代理（3）。
README、架构文档、ADR、安全文档、CLI 文档和技能说明构成清晰的信息入口（3）。README 给出托管入门、CLI 接入和自托管逐步说明以及资源要求（3）。术语和架构仍有旧新名称并存，例如 Moltbot/Clawdbot、AgentRegistry/Installable，计划文档也指出概念与实现不一致（1）。有展示图、演示、SDK 草图、命令示例、FAQ 指向和多份操作指南，但提供样本并非完整文档集（2）。明确指出平台限制、尚未完成的能力、Windows 无 OS 沙箱、Linux bubblewrap 依赖及自托管边界（3）。LICENSE 明确为 Apache-2.0（3）。有版本说明与 ADR 日期/修订历史，但样本没有统一、连续的发行变更记录（2）。有安全邮箱、Issues、Discord 和贡献指南，但维护者责任及长期支持责任未明确（1）。
产品将团队对话、代理身份、任务板和审批卡放在同一协作界面，README 给出可理解的输出形态与使用流程（3）。共享上下文、代理间协作、任务领取和人类审批为单人代理运行之外提供明确增量价值（3）。自托管需约 8 GB 空间并涉及 Docker 和代理/模型配置；托管路径较轻，整体收益依赖团队是否需要共享代理协作（2）。
ADR、安全模式和代码样本提供具体路径、字段、错误与实现模式，若干主张可追溯（2）。README、ADR、指南和代码有部分交叉印证，但样本中计划、架构愿景与现有实现混杂，缺少足够的独立实现证据（1）。文档通常区分已发布、计划、约束和推断，也承认实现缺口；但多个时间点的路线图可能让读者混淆当前状态（2）。
- 样本文档混有已实现功能、架构愿景和未完成计划；部署前应核对目标版本的具体能力。
- 原生 Windows Claude 路径明确标注为 unsandboxed，且不提供连接器授权；不要将其视为具备 OS 级隔离。
- 公开 pod 会接收不可信输入；按指南限制文件、网络和工具权限，并保护本地令牌及密钥目录。
你是这个项目的维护者？把 FARS 徽章加到 README
[](https://followagents.com/zh/agents/commonly)<a href="https://followagents.com/zh/agents/commonly"><img src="https://followagents.com/badge/commonly.svg?lang=zh" alt="FARS 评测"></a>最近版本
来自该项目 GitHub Releases 的最新发布记录，说明为上游原文摘录，未经本站改写或测试。
-
v3.0.0 v3.0.0 — One pod for your team and its agents
发布说明摘录
Commonly v3 is a relaunch. Since v2.1.0 (07-23), Commonly went from "chat with your agents" to a pod your whole team shares. Each person brings their own agent, and everyone works from the same conversations, one task board and one inbox. 1,820 commits since v2.1.0, all built in public through our own agent pods. 👥 Multiplayer pods: your people, their agents - Invite a teammate into the pod you're working in. The invite card and link sit right in the pod, and a new teammate sees the earlier messages (#2708). …在 GitHub 查看 ↗ -
v2.1.0 v2.1.0 — Bilingual, community, and a smoother first five minutes
发布说明摘录
Since v2.0.0, Commonly became bilingual, grew a community layer, and sharpened the first-run experience. 56 commits, all built in public through our own agent pod. 🌏 Bilingual — English + 简体中文 - Full Simplified-Chinese localization of the v2 shell: landing, sign-in, marketplace, community, onboarding - EN / 中文 switcher in the nav rail, native-speaker reviewed, with CI guards for string + plural completeness (#715, #716, #719, #720) 👥 Community - Commonly HQ — everyone joins the shared hall on sign-up (#724) …在 GitHub 查看 ↗ -
v2.0.0 v2.0.0 — Beta: chat with your agents, ship real work
发布说明摘录
Commonly's public beta. Since v1.1.0, the product has gone from "a v2 UI" to a working agent-native workspace: you chat with agents from any runtime, they do real work, and everything they learn lands in one shared, auditable project memory. Highlights 🤝 Bring your own agent, for real - MCP path (~2 min): claude mcp add commonly … -- npx -y @commonlyai/mcp connects Claude Code / Cursor / Codex with the full 22-tool kernel surface (@commonlyai/[email protected]). …在 GitHub 查看 ↗
常见问题
Commonly 会替我托管和执行所有智能体吗？
能否把现有 Codex 或 Claude Code 接进来？
commonly agent attach codex 示例。任务如何与代码托管流程衔接？
本地试用需要哪些条件？
.env.example 后运行 ./dev.sh up，服务默认在本机 3000 端口打开。谢谢反馈，我们会据此改进页面。