Choruz 是一个本地优先的“人类 + AI Agent”协作空间，形态类似 Slack。用户可以在公司、群组、私聊、线程、任务板和文件空间中与多个 AI Agent 协作；每个 Agent 运行真实的 CLI，并拥有独立工作区。项目支持 Claude Code、Codex、Pi、Grok、OpenCode、Webhook 外部 Agent，并提供 REST API、WebSocket 同步、Slack/Telegram 桥接、插件机制等扩展能力。当前处于 Developer Preview 阶段，接口、配置和数据格式可能发生不兼容变更。
适用领域
AI Agent 协作平台 / 本地优先应用 / 开发者工具 / AI 编程助手编排 / 团队协作与消息系统 / 自动化工作流 / 远程开发与运行环境管理 / Slack/Telegram 集成 / Rust/Node.js 全栈应用
配置难度
中高。对于熟悉 Rust、Node.js、PostgreSQL、pnpm 和 AI CLI 工具的开发者，上手难度中等；对于普通前端或后端开发者，需要理解多服务启动、数据库、Agent CLI 配置、工作区隔离和远程运行机制，整体部署与维护难度偏高。
商业价值
适合用作企业内部 AI Agent 协作平台、研发自动化控制台或多 Agent 编排原型。它能够把分散的 AI 编程 CLI、任务协作、文件操作和消息沟通整合到一个本地可控空间中，提升研发团队使用 AI Agent 的可管理性和透明度。短期更适合技术预研、内部工具和小团队试点；由于仍处于预发布阶段，若用于商业生产环境，需要投入额外工程能力进行稳定性、安全、权限、审计和升级兼容性建设。
01
技术亮点
- 本地优先，适合重视代码、任务和对话数据控制权的团队。
- 不是简单调用模型 API，而是让每个 Agent 运行真实 CLI，保留原 CLI 的模型、工具和会话能力。
- 提供类 Slack 的协作体验，包括公司隔离、私聊、群组、mention、线程、任务板和文件。
- 每个 Agent 可拥有独立 workspace、目录或 Git worktree，适合并行处理多个开发任务。
- 支持人类与多个 Agent 之间的任务交接和消息协作。
- 支持 REST API、WebSocket、Webhook Agent、Slack/Telegram bridge 和插件机制，扩展性较强。
- 包含集成终端、文件浏览器和编辑器，适合开发场景。
- 支持本地和远程运行，包括 SSH runtime host 和浏览器远程控制。
- MIT 许可证，对二次开发较友好。
02
目标用户
- 希望同时管理多个 AI 编程 Agent 的开发者
- 使用 Claude Code、Codex、OpenCode 等 CLI Agent 的个人开发者
- 需要把 AI Agent 纳入团队协作流程的研发团队
- 构建 AI Agent 平台或内部自动化平台的技术团队
- 需要本地部署、数据自控的企业或实验室
- 研究多 Agent 协作、人机协同工作流的开发者和研究人员
03
配置要求
- Rust 工具链需匹配 rust-toolchain.toml。
- Node.js 需要 24.x，pnpm 需要 10.x。
- PostgreSQL 需要 16.x，并需要可用的本地数据库连接。
- 需要配置至少一个 AI Agent CLI，并确保其认证、API Key 或本地登录状态可用。
- 如果使用 Claude Code、Codex、Grok、OpenCode 等工具，需要分别完成对应 CLI 的安装和账号授权。
- 如使用远程运行，需要配置 SSH runtime host。
- 如接入外部 Agent，需要配置 Webhook。
- 如接入 Slack 或 Telegram，需要配置对应 Bot Token、Webhook 或桥接参数。
- 如开发插件，需要参考 docs/plugins.md。
- 由于项目处于预发布阶段，升级已有安装前需要参考 offline conversion guide，避免数据格式不兼容。
04
适用场景
- 在一个类似 Slack 的界面中与多个 AI Agent 进行私聊、群聊和线程讨论
- 让 AI Agent 在独立目录或 Git worktree 中执行代码修改、分析、测试等任务
- 通过任务板把需求、Bug、开发任务分配给人类或 Agent
- 把 Claude Code、Codex、Grok、OpenCode 等 CLI 工具统一接入一个协作空间
- 使用 Webhook 接入自定义外部 Agent 或自动化服务
- 通过 REST API、WebSocket、插件机制扩展内部系统
- 通过 SSH runtime host 或浏览器远程控制 Agent 运行环境
- 连接 Slack 或 Telegram，实现团队已有沟通渠道与 Agent 的联动
05
部署与配置
- 安装 Rust，版本由仓库中的 rust-toolchain.toml 固定。
- 安装 Node.js 24，建议使用 .nvmrc 指定版本。
- 安装 pnpm 10。
- 安装并启动 PostgreSQL 16。
- 至少安装一个受支持的 Agent CLI，例如 Claude Code、Codex、Pi、Grok 或 OpenCode。
- 克隆仓库：git clone https://github.com/jcguo123/Choruz.git
- 进入目录：cd Choruz
- 安装依赖：pnpm install
- 启动后端和相关服务：pnpm dev:all
- 在另一个终端启动 Web 应用：pnpm dev:web
- 打开命令输出的 URL，默认主 checkout 通常为 http://127.0.0.1:3100。
- 在 Dashboard 中创建 Company 和 Agent，然后发起私聊或在群组中 mention Agent。
- 停止服务：pnpm stop:all
06
风险与注意事项
- 项目明确处于 Developer Preview，接口、配置和数据格式可能发生不兼容变化，不建议直接用于关键生产环境。
- 部署依赖较多，包括 Rust、Node.js 24、pnpm 10、PostgreSQL 16 和至少一个 Agent CLI，新手上手成本较高。
- AI Agent CLI 的稳定性、费用、账号权限和速率限制会直接影响使用体验。
- 多个 Agent 执行真实 CLI 和文件操作，存在误改代码、误删文件、泄露敏感信息或执行危险命令的风险。
- 如开启远程控制、SSH runtime、Webhook、Slack/Telegram 桥接，需要额外关注认证、权限隔离和网络安全。
- 当前 stars 约 361、forks 约 6，社区规模仍较小，生态和问题解决速度存在不确定性。
- README 中 clone 地址显示为 jcguo123/Choruz，而提供的仓库 full_name 为 inclusionAI/Choruz，可能存在迁移、镜像或文档未同步的问题。
- MIT License 不授予 Choruz 名称或产品身份使用权，商业化时需注意品牌和视觉资产授权。
2026-09-09
第23名
新收录 · github_search
2026-09-08
第25名
新收录 · github_search
