企业级多智能体编码工作区,统一管理本地 AI 编码代理的会话、并行开发、MCP/Skills 管理及聊天频道交互。
Codeg 是一个企业级多智能体编码工作区,由作者 xintaofei 以 Apache-2.0 许可证开源维护。项目核心解决多 AI 编码代理(Claude Code、Codex CLI、OpenCode、Gemini CLI、Cline 等)各自独立、会话分散的问题,提供统一的会话聚合与结构化渲染能力。
架构概览#
Codeg 采用 Next.js 16(静态导出)+ React 19 作为前端,Tauri 2 作为桌面框架,后端基于共享 Rust 核心层(含 Axum HTTP + WebSocket 服务器),数据持久化使用 SQLite + SeaORM。前端通过传输抽象层屏蔽了 Tauri IPC 与 HTTP/WebSocket 的差异,使得同一套前端代码可同时服务于桌面应用和独立 Web 服务器两种部署模式,此外还支持 Docker 容器化部署。
三种部署模式:桌面应用、独立服务器、Docker 容器,运行平台覆盖 macOS、Linux、Windows。
核心能力#
- 多代理统一管理:通过 ACP(Agent Client Protocol)连接多个本地编码代理,摄取并解析其本地会话日志,以结构化方式展示对话历史
- 并行开发:内置 git worktree 工作流,支持在多个分支上同时驱动不同代理并行开发
- Project Boot(项目引导):可视化脚手架工具,分屏配置 + 实时预览,支持 shadcn/ui 项目模板,框架覆盖 Next.js / Vite / React Router / Astro / Laravel
- MCP 与 Skills 管理:MCP 工具的本地扫描、注册表搜索与安装;全局与项目范围的 Skills 管理
- 集成工程循环:文件树浏览、diff 查看、git 变更与提交、内置终端
Chat Channels#
Chat Channels 是 Codeg 的差异化特性,已支持连接 Telegram、Lark(飞书)、iLink(企业微信):
- 从聊天应用发起/继续/取消代理任务
- 代理权限审批(
/approve、/deny) - 实时事件通知(工具调用、错误、完成摘要)
- 查询命令(
/search、/today、/status) - 定时日报(对话统计、代理类型分布、项目活动)
- 10 种语言消息模板
Discord、Slack、钉钉等通道标记为计划中,尚无明确时间线。
隐私安全#
Codeg 坚持本地优先策略,会话解析与存储均在本地完成,采用 token-based 认证,凭证存储于 OS Keyring,并支持企业系统代理。
安装部署#
一行脚本安装:
curl -fsSL https://raw.githubusercontent.com/xintaofei/codeg/main/install.sh | bash
codeg-server
Docker 部署:
docker run -d -p 3080:3080 -v codeg-data:/data ghcr.io/xintaofei/codeg:latest
预编译二进制: GitHub Releases 页提供 Linux x64/arm64、macOS x64/arm64、Windows x64 预构建包。
环境变量配置:
| 变量 | 默认值 | 说明 |
|---|---|---|
CODEG_PORT | 3080 | HTTP 端口 |
CODEG_HOST | 0.0.0.0 | 绑定地址 |
CODEG_TOKEN | 随机生成 | 认证令牌 |
CODEG_DATA_DIR | ~/.local/share/codeg | 数据库目录 |
待确认信息#
- ACP(Agent Client Protocol)协议细节:README 中提及但未提供外部规范链接,是否为自定义协议待确认
- OpenClaw 代理的生态成熟度及实际集成深度待确认
- 独立官网/文档站尚未建立,文档均内嵌于 GitHub 仓库
项目当前版本为 v0.9.5,累计 704 次提交、70 个 Release,处于活跃迭代状态。