Commonly
让不同运行时的 AI 队友在共享工作空间中协作交付。
- Star 数
- ★ 1.4k
- 最近更新
- 今天
- License
- Apache-2.0
- 主语言
- TypeScript
- FA 评分
- 44/100 · 缺口较多
30 秒速览
- 可在哪里用
- 通用 · 跨平台Codex · Claude Code
- 开始前需要
- 典型场景
- 研发负责人要让 Claude Code、Codex 与自定义 HTTP 智能体围绕同一 GitHub 项目协作，同时在一个 Pod 中共享任务和项目上下文。
- 主要局限
- 本地启动明确依赖 Docker 与 Docker Compose；生产 Kubernetes、云沙箱或外部运行时的配置复杂度会更高。
这个 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 当前 | 44 · 缺口较多 | ★ 1.4k | 今天 | TypeScript | Codex · Claude Code |
| Hope Agent | 40 · 缺口较多 | ★ 1.6k | 4 天前 | Rust | Codex · OpenAI API · Claude API |
| Octop 自托管 AI 助手 | 67 · 存在缺口 | ★ 4.8k | 今天 | Python | Codex · Claude Code · OpenAI API |
| AgentRQ | 64 · 存在缺口 | ★ 1.1k | 今天 | Go | Codex · Claude Code |
FollowAgents 如何评估这个 Agent？
查看各维度的扣分理由
证据显示：README 提到 RBAC、scoped tokens、audit log，但未提供具体实现细节；部署工作流使用 Workload Identity Federation 避免长期凭证，但未展示用户确认机制；数据流描述在架构图中，但未详细说明敏感数据（如 API 密钥）的处理；依赖安全未提及；外部效果（如 GitHub 集成）有描述但无权限控制细节；回滚在部署工作流中提及但未提供具体机制；来源归属有 PR 标签和提交历史，但未验证。扣分原因：缺乏具体实现证据，用户确认机制缺失，敏感数据处理不透明。
证据显示：README 和文档结构一致，但未提供测试结果；依赖可用性未提及；失败消息在部署工作流中有部分描述（如 rollout 失败），但未提供用户可见的错误处理。扣分原因：依赖可用性未提及，失败消息不完整。
证据显示：README 明确目标用户（人类和 AI 代理）和场景（协作、任务管理）；能力边界在文档中有描述（如 Installable taxonomy）；触发精度未详细说明；环境适配有 Docker、Kubernetes 等部署选项。扣分原因：触发精度缺乏具体细节。
证据显示：信息架构清晰（README、docs、项目结构）；安装说明详细（Quick Start）；命名稳定性未提及；示例和 FAQ 有文档；已知限制在 README 中提及（'Commonly is early'）；许可证为 Apache 2.0；版本和变更日志未提及；维护责任有贡献指南。扣分原因：命名稳定性、版本和变更日志缺失。
证据显示：输出可用性有示例（如 PR、文档）；边际价值有明确价值主张（避免重复解释）；成本效益有自托管选项。扣分原因：缺乏实际使用数据，成本效益未量化。
证据显示：README 中的声明有部分文档支持（如架构、API）；跨来源验证有限；事实和推断未明确区分。扣分原因：声明可追溯性不足，跨来源验证有限。
- 源码中未见：执行前用户确认开启或自行加上执行前确认；先在沙箱或测试环境跑通，确认行为后再接入真实数据。
- 源码中未见：依赖安全审查安装前固定版本并做一次依赖扫描（如 npm audit、pip-audit）；优先放在容器里运行。
- 未验证发布者身份，需谨慎对待来源。
- 依赖安全未提及，需检查依赖漏洞。
- 用户确认机制缺失，需注意代理操作的授权。
- 敏感数据处理不透明，需审查密钥管理。
常见问题
Commonly 会替我托管和执行所有智能体吗？
能否把现有 Codex 或 Claude Code 接进来？
commonly agent attach codex 示例。任务如何与代码托管流程衔接？
本地试用需要哪些条件？
.env.example 后运行 ./dev.sh up，服务默认在本机 3000 端口打开。