Apache License 2.0

技术解读

以下内容由 GitRead 中文社区 编辑团队基于项目 README 与官方资料整理, 结合中文开发者的常见使用场景补充技术选型建议。具体以项目官方文档为准。

xintaofei/codeg 深度技术分析

项目背景与痛点

在当今社会,代码协作变得越来越重要,特别是在分布式团队和多任务场景下。然而,现有的协作工具大多集中在代码管理和文档协作,缺乏强大的多智能体人工智能(AI)辅助功能。xintaofei/codeg 的出现正是为了填补这一空白,通过聚合来自 Claude Code, Codex, OpenCode, Pi, Grok Build 等多个 AI 编码助手的会话,以实现更高效和智能的多代理协作开发环境。

核心技术揭秘

技术架构分析

xintaofei/codeg 搭建了一个覆盖多平台的协作环境,支持桌面应用程序、自托管服务器,以及 Docker 容器化部署。其核心在于利用先进的 AI 工具集成,提供了强大的协作平台。

graph TD A[用户请求] --> B{"参数校验"} B -->|"通过"| C[执行业务] C --> D[数据处理] D --> E{"环境检测"} E -->|"桌面客户端"| F[桌面应用程序] E -->|"服务器托管"| G[自托管服务器] E -->|"容器化部署"| H[Docker 容器]

技术栈:

  • 前端:Vue.js 框架构建桌面应用程序,提供用户友好的开发界面。
  • 后端:采用 Node.js 构建核心服务,支持多代理服务集成。
  • 数据处理:使用 Redis 作为中间件,优化数据流和状态管理。
  • 部署:支持 Docker 部署,提供灵活部署场景。

实现原理: 核心业务流程是从用户请求开始的,请求在经过参数校验后进入核心业务执行阶段。在数据处理层,系统负责与各种代理工具通信,整合异构服务的数据流,确保数据一致和高效传输。环境检测用于判断部署环境,以便正确选择桌面客户端、自托管服务器或 Docker 部署方案。

功能亮点与差异

xintaofei/codeg 在功能上不仅集成了诸多 AI 编码助手,还提供了丰富的用户交互接口和多种部署选项。尤其在多代理工具整合方面,具有显著优势。相比于单一功能的竞争对手,如单一语言代码生成工具,代码g 提供了更为综合的编译环境,不仅支持编码,还包括调试、文档编写与协作支持功能。

通过最大限度减少编码工作量,提高开发团队在代码质量和准确性方面的能力,进一步提升多团队协作效率。

应用场景与落地建议

尽管 codeg 提供了一个强大的协作工具,但在生产环境实际落地时,应注意:

  • 部署灵活性:根据团队的实际需求,可选择适合的部署方式(桌面应用、托管服务、Docker 部署)。
  • 数据保护机制:确保客户端与代理工具之间的数据交互安全,特别是在跨平台数据传递中,保证数据一致性。
  • 多项目管理:对于涉及多项目合作的团队而言,需要关注对多个项目的动态管理机制,提高多团队协同效率。

该工具非常适合跨地域的分布式团队、需要多代理协同工作的复杂研发场景、以及对代码质量有高要求的项目。

综合评价

优:

  • 强大的多代理集成能力,支持多种 AI 编码辅助工具。
  • 灵活的部署方案,适应不同规模和需求的项目使用。
  • 提供丰富的前端用户体验,支持桌面应用程序,直接与开发者沟通。

缺点:

  • 安全性与数据保护机制需要加强,特别是跨平台时确保数据一致性。
  • 对于大规模团队的多项目管理的支持有待优化,动态项目管理功能还需提高。
  • 部署选项丰富,但可能增加管理复杂性,适配团队需求存在难度。

总的来说,xintaofei/codeg提供了一个功能齐全且创新的多代理协作环境,极大地提升了开发流程的效率与协作质量,是值得具备一定技术基础的团队尝试的方案。

关于

GitHub 原始描述(英文)

Collaborative multi-agent AI coding workspace: aggregate sessions from Claude Code, Codex, OpenCode, Pi, Grok Build, etc. Desktop app, self-hosted server, or Docker.

描述取自 GitHub 官方 API,保持仓库作者书写的原文。

语言占比

CSS
Dockerfile
HTML
JavaScript
NSIS
PowerShell
Python
Rust
Shell
TeX
TypeScript

Release

README

Codeg logo Codeg

GitHub stars Latest release Total downloads License Documentation Platforms: macOS, Windows, Linux, Docker, iOS, Android

English · 简体中文 · 繁體中文 · 日本語 · 한국어 · Español · Deutsch · Français · Português · العربية

The multi-agent coding workspace.
Run every AI coding agent in one place — and let them work together.

Download Codeg · Documentation

The Codeg workspace: a conversation with an agent beside its live diffs and the project's files

🧩 One interface for every agent
Twenty agents built in, and any ACP agent can join — all rendered as the same structured conversation, not a terminal.
🔎 Sessions that travel
Import, search, and resume the history every agent keeps on disk, then hand it to a different agent.
🤝 Agents that work together
Delegate across agents with an @, or queue to-dos that run unattended in their own worktrees.
🌍 Wherever you work
Desktop app, self-hosted server or Docker, iPhone, iPad, and Android — and Telegram, Lark, or WeChat.

💖 Sponsors

Compshare
Compshare (UCloud)
Thanks to Compshare for sponsoring this project! Compshare is UCloud's AI cloud platform, offering cost-effective monthly and pay-as-you-go agent Plan subscriptions for Chinese models, starting at just ¥49/month. It also provides stable officially-proxied access to overseas models. Supports Claude Code, Codex, and API integrations. Enterprise-ready with high concurrency, 24/7 technical support, and self-service invoicing. Users who sign up via this link receive ¥5 in free platform credits!
合租巴士
合租巴士
Thanks to 合租巴士 for sponsoring this project! 合租巴士 is a reliable and efficient AI relay platform, offering highly stable relay for mainstream models such as Codex and Claude Code. Top-ups are credited at a transparent 1:1 ratio, with Codex rate subsidies as low as 0.08. Join the group via the official website to get $5 in trial credit.
APIMart
APIMart
Thanks to APIMart for sponsoring this project! APIMart is a low-cost API platform for AI image & video generation — GPT-Image-2 from $0.006/image, 160+ images per dollar. One async API covers both image and video: submit a task, get an ID, fetch results via polling or callback. Batch tens of thousands of images without timeouts, switch models without changing code. Pay-as-you-go with no monthly fee — sign up here to get started.
UCloud ·星图AstraFlow
UCloud ·星图AstraFlow
UCloud ·星图AstraFlow
UCloud's AstraFlow large-model platform gives you one-click access to 200+ models: leading open-source models such as Kimi K3, DeepSeek V4/V3, Qwen 3, GLM5.2, and happyhorse are built in — no training of your own required, ready to use out of the box.
Sign up with your email through the link above, complete real-name verification, and claim ¥50 in compute credits.
Sidrune AI
Sidrune AI
Thanks to Sidrune AI for sponsoring this project! Sidrune AI gives you access to GPT, Claude, and other major AI models through a single API. New users who sign up through our dedicated link with promo code SDRCODEG get $3 in API credits.
BeeAPI
BeeAPI
Thanks to BeeAPI for sponsoring this project! BeeAPI is a professional multi-model AI API relay and aggregation platform that brings together many providers and a wide range of mainstream AI models. It supports cross-vendor price comparison, smart routing across groups, and unified API access and billing, helping you call AI services more flexibly, reliably, and at a lower cost.

Want to become a Codeg sponsor? Reach out to us by email.

✨ Features

One Interface for Every Agent

Twenty agents, plus any ACP agent, in one rich chat with tool cards, live diffs, and interactive replies.

Docs → · Custom agents → · UI Render →

One Interface for Every Agent

Every Session, Searchable

Import, search, and resume any agent’s history. Share sessions with @ mentions and organize them with tags.

Docs → · Tags →

Every Session, Searchable

Multi-Agent Collaboration

@ an agent to delegate. Run agents side by side and watch their progress stream into your conversation.

Docs →

Multi-Agent Collaboration

To-dos That Run Unattended

Schedule tasks in isolated worktrees. Agents handle the work; you review and approve the changes.

Docs → · Auto-processing →

To-dos That Run Unattended

Infinite Canvas

Arrange chats, files, terminals, and notes on an infinite board. Keep every agent’s work in view.

Docs →

Infinite Canvas

Desktop, Server, Mobile & Chat

Work on desktop, server, Docker, or mobile. Reach your agents through Telegram, Lark, and WeChat.

Docs → · Remote workspaces → · Mobile apps → · Chat channels →

Desktop, Server, Mobile & Chat

Office Documents & Research

Create Office files with live previews and view PDFs beside chat. Research skills work with any agent.

Docs → · Research →

Office Documents & Research

Browser & Computer Use

Share pages and errors from the desktop browser. Let agents operate shared windows with Computer Use (preview).

Docs → · Computer Use →

Browser & Computer Use

Command Line & CI

Run prompts from scripts or CI with codeg-cli. Connect to a running Codeg for replies or JSON events.

Docs →

codeg-cli -a codex \
  -p "Review the latest commit"

git diff | codeg-cli -a codex \
  -p "Review this diff"

Also in the box:

  • The Full Engineering Loop — a code editor, live diffs, Git & worktrees, a three-pane merge editor, terminals, and split views
  • Repository Panel — issues, pull requests, checks, and merges for GitHub, GitLab, Gitea, and Forgejo; any issue or PR can become a to-do
  • Automations — save a configured composer and run it headlessly, on a cron schedule or on demand
  • Token Usage — trends, cache hit rate, an activity heatmap, usage by folder, agent, model, and session, and what it would cost at API list prices
  • Fork & Steer — fork a conversation from a finished reply, or send a message into a turn that is still running, on agents that support it
  • Skills & MCP — skill packs per agent, a local MCP scan, and registry search and install
  • Project Boot — scaffold a new project visually, with a live preview
  • Notifications — desktop notifications, sounds, and a flashing taskbar button or bouncing Dock icon when a turn ends or an agent needs you
  • Make It Yours — twelve themes you can recolor token by token, wallpapers, corner radius, chat width, custom CSS, and a desktop pet — in any of ten interface languages
  • Backup & Sync — encrypted backups, and configuration sync between machines through a file or your own WebDAV server
  • URL Scheme — codeg://session/<id> opens a conversation from another app (desktop)
  • And more — nearly every release adds something; the release notes are the full list

🤖 Supported Agents

Codeg talks to every agent over the Agent Client Protocol, so each one gets the same structured interface. Twenty come built in, and Codeg installs, pins, and updates most of them for you:

Claude Code   Codex   Gemini CLI   OpenClaw   OpenCode   Cline   Hermes Agent   CodeBuddy   Kimi Code   MiniMax Code   Pi   Grok   Cursor   DeepSeek Harness   Qoder   Google Antigravity   Kiro CLI   ZCode   TRAE CLI   Command Code   + any ACP agent

Not on the list? Pick any agent from the public ACP registry or paste its distribution JSON — Codeg installs it, checks that it launches, and treats it like a built-in. Runtime requirements and where each agent keeps its sessions: Supported Agents.

📦 Install

Desktop — installers for macOS, Windows, and Linux are on Releases; setup steps in Installation.

Server — run Codeg headless and reach it from any browser. On Linux or macOS:

curl -fsSL https://raw.githubusercontent.com/spacering-net/codeg/main/install.sh | bash
CODEG_STATIC_DIR=/usr/local/share/codeg/web codeg-server

On Windows, in PowerShell:

irm https://raw.githubusercontent.com/spacering-net/codeg/main/install.ps1 | iex
$env:CODEG_STATIC_DIR="$env:LOCALAPPDATA\codeg-server\web"; codeg-server

Docker — the same server, in one container:

docker run -d -p 3080:3080 -v codeg-data:/data ghcr.io/spacering-net/codeg:latest

Either way, open http://<host>:3080 in a browser and enter the access token the server prints when it starts (docker logs shows it for the container), or set CODEG_TOKEN to choose your own.

Mobile — install the iOS app or the Android APK, then point it at the Web Service of your desktop app or at your own codeg-server: URL, token, done. Pairing steps in Mobile apps.

Compose, prebuilt binaries, source builds, and in-place updates are covered in Deployment; environment variables in Configuration.

👥 Community & Support

  • WeChat — scan the QR code to join our group for discussions, feedback, and updates:

    WeChat
  • Issues — found a bug or missing a feature? Open an issue.

  • Privacy — local-first: parsing, storage, and project operations stay on your machine, and web and server modes are guarded by token authentication. Details in Privacy & Security.

  • LinuxDO — thanks to the LinuxDO community for their support.

  • Show support — star the repo to follow along.

🤝 Contributing

Issues and pull requests are welcome. To build Codeg yourself, start with Development and Architecture.

Codeg contributors

⭐ Star History

Star History Chart

🙏 Acknowledgments

📜 License

Apache-2.0. See LICENSE.

评论

暂无评论