README.md

Codeg

_{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

🧩 One interface for every agent Nineteen 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 (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	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'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	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	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 Nineteen agents, plus any ACP agent, in one rich chat with tool cards, live diffs, and interactive replies. Docs → · Custom agents → · UI Render →
Every Session, Searchable Import, search, and resume any agent's history. Share sessions with @ mentions and organize them with tags. Docs → · Tags →
Multi-Agent Collaboration @ an agent to delegate. Run agents side by side and watch their progress stream into your conversation. Docs →
To-dos That Run Unattended Schedule tasks in isolated worktrees. Agents handle the work; you review and approve the changes. Docs → · Auto-processing →
Infinite Canvas Arrange chats, files, terminals, and notes on an infinite board. Keep every agent's work in view. Docs →
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 →
Office Documents & Research Create Office files with live previews and view PDFs beside chat. Research skills work with any agent. Docs → · Research →
Browser & Computer Use Share pages and errors from the desktop browser. Let agents operate shared windows with Computer Use (preview). Docs → · 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. Nineteen 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   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:

  

• 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.

⭐ Star History

🙏 Acknowledgments

• Agent Client Protocol — the foundation that lets Codeg connect to every agent it supports
• Superpowers — powers Codeg's expert skills module
• OfficeCLI — powers Codeg's Office documents workflow
• scientific-agent-skills — powers Codeg's Scientific Research skills (MIT-licensed subset)
• json-render — powers Codeg's UI Render cards, tables, and charts
• cua-driver — powers Codeg's Computer Use

📜 License

Apache-2.0. See LICENSE.