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
Fifteen 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.](mailto:itpkcn@gmail.com) ## ✨ Features
### One Interface for Every Agent Fifteen agents come built in, and any other ACP agent can join from the public registry or its distribution JSON. Codeg speaks the Agent Client Protocol to every one of them, so they all get the same rich conversation — tool cards, live diffs, plans, and permission prompts — instead of a terminal to squint at. Enable UI Render for an agent and it can answer with interactive cards, tables, and charts. [Docs →](https://docs.codeg.app/guide/supported-agents) · [Custom agents →](https://docs.codeg.app/guide/custom-agents) · [UI Render →](https://docs.codeg.app/guide/skills#cards-tables-and-charts-in-replies) One Interface for Every Agent
### Every Session, Searchable Codeg reads the history every agent CLI keeps on disk: import it in one click, search all of it, and resume any session where it stopped. `@`-mention an old session and the agent you're talking to can read it — even one a different agent wrote. Give conversations colored tags, global or per folder, and filter the sidebar by them. [Docs →](https://docs.codeg.app/guide/aggregation) · [Tags →](https://docs.codeg.app/guide/workspace#tag-conversations) Every Session, Searchable
### Multi-Agent Collaboration Type `@`, pick an agent, send. Each mentioned agent runs as its own session, side by side, streaming back into your thread — Claude Code drafting while Codex reviews — and sub-agents show up as cards that fill in while they work. [Docs →](https://docs.codeg.app/guide/multi-agent) Multi-Agent Collaboration
### To-dos That Run Unattended Write a job down and walk away. Each to-do gets its own git worktree and branch, starts now or on a schedule, and then waits for your review; accept the diff and the agent lands it, and Codeg checks git before calling it done. The repository panel can add them for you, too: it picks up issues and pull requests by label and author, on a schedule or when a webhook fires. [Docs →](https://docs.codeg.app/guide/tasks) · [Auto-processing →](https://docs.codeg.app/guide/repository#let-it-pick-items-up-by-itself) To-dos That Run Unattended
### Infinite Canvas Lay your work out in space: conversations, files, terminals, and notes become cards on a board, grouped by folder and agent, so several agents can run side by side in plain sight. [Docs →](https://docs.codeg.app/guide/canvas) Infinite Canvas
### Desktop, Server, Mobile & Chat Run Codeg as a desktop app, a self-hosted server you open in any browser, or a single Docker container, and open a remote server from the desktop app in a workspace window of its own. Native iPhone, iPad, and Android clients — plus Telegram, Lark, and WeChat channels — keep your agents in reach, while your files and sessions stay on machines you control. [Docs →](https://docs.codeg.app/getting-started/deployment) · [Remote workspaces →](https://docs.codeg.app/guide/workspace#desktop-and-browser) · [Mobile apps →](https://docs.codeg.app/getting-started/installation#mobile-apps) · [Chat channels →](https://docs.codeg.app/guide/chat-channels) Desktop, Server, Mobile & Chat
### Office Documents & Research Ask for a deck, a report, or a workbook and watch the real `.pptx`, `.docx`, or `.xlsx` render live beside the conversation; PDFs get a viewer of their own. Bundled research skills — hypotheses, experimental design, statistics, literature search — work with any agent. [Docs →](https://docs.codeg.app/guide/office) · [Research →](https://docs.codeg.app/guide/research) Office Documents & Research
### Browser & Computer Use In the desktop app, links open in a built-in browser beside your files, at desktop, tablet, or phone size: hand the agent a page, an element, a screenshot, or a console error, or let it drive a page you share. In preview, agents can also see and operate the windows you share — and Stop is one click away. [Docs →](https://docs.codeg.app/guide/browser) · [Computer Use →](https://docs.codeg.app/guide/computer-use) Browser & Computer Use
### The Full Engineering Loop An editor, live and side-by-side diffs, a full git client with a three-pane merge editor, one-click worktrees, an embedded terminal, and split views — all next to the agent, on the real files in your repo. [Docs →](https://docs.codeg.app/guide/workspace) · [Git & worktrees →](https://docs.codeg.app/guide/git) The Full Engineering Loop
**Also in the box:** - **[Repository Panel](https://docs.codeg.app/guide/repository)** — issues, pull requests, checks, and merges for GitHub, GitLab, Gitea, and Forgejo; any issue or PR can become a to-do - **[Automations](https://docs.codeg.app/guide/automations)** — save a configured composer and run it headlessly, on a cron schedule or on demand - **[Token Usage](https://docs.codeg.app/guide/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](https://docs.codeg.app/guide/workspace#follow-along-%E2%80%94-the-conversation)** — fork a conversation from a finished reply, or send a message into a turn that is still running, on agents that support it - **[Skills](https://docs.codeg.app/guide/skills) & [MCP](https://docs.codeg.app/guide/mcp)** — skill packs per agent, a local MCP scan, and registry search and install - **[Project Boot](https://docs.codeg.app/guide/project-boot)** — scaffold a new project visually, with a live preview - **[Notifications](https://docs.codeg.app/reference/settings/general#desktop-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](https://docs.codeg.app/reference/settings/appearance)** — 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](https://docs.codeg.app/reference/settings/system#backup-restore)** — encrypted backups, and configuration sync between machines through a file or your own WebDAV server - **[URL Scheme](./docs/url-scheme.md)** — `codeg://session/` opens a conversation from another app (desktop) - **And more** — nearly every release adds something; the [release notes](https://github.com/spacering-net/codeg/releases) are the full list ## 🤖 Supported Agents Codeg talks to every agent over the [Agent Client Protocol](https://agentclientprotocol.com), so each one gets the same structured interface. Fifteen 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   + 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](https://docs.codeg.app/guide/supported-agents). ## 📦 Install **Desktop** — installers for macOS, Windows, and Linux are on [Releases](https://github.com/spacering-net/codeg/releases/latest); setup steps in [Installation](https://docs.codeg.app/getting-started/installation). **Server** — run Codeg headless and reach it from any browser. On Linux or macOS: ```bash 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: ```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: ```bash docker run -d -p 3080:3080 -v codeg-data:/data ghcr.io/spacering-net/codeg:latest ``` Either way, open `http://: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](https://apps.apple.com/app/codeg-client/id6785199071) or the [Android APK](https://github.com/xintaofei/codeg-android/releases/latest), 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](https://docs.codeg.app/getting-started/installation#mobile-apps). Compose, prebuilt binaries, source builds, and in-place updates are covered in [Deployment](https://docs.codeg.app/getting-started/deployment); environment variables in [Configuration](https://docs.codeg.app/getting-started/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](https://github.com/spacering-net/codeg/issues). - **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](https://docs.codeg.app/reference/privacy). - **LinuxDO** — thanks to the [LinuxDO](https://linux.do) community for their support. - **Show support** — [star the repo](https://github.com/spacering-net/codeg) to follow along. ## 🤝 Contributing Issues and pull requests are welcome. To build Codeg yourself, start with [Development](https://docs.codeg.app/reference/development) and [Architecture](https://docs.codeg.app/reference/architecture). Codeg contributors ## ⭐ Star History Star History Chart ## 🙏 Acknowledgments - [Agent Client Protocol](https://agentclientprotocol.com) — the foundation that lets Codeg connect to every agent it supports - [Superpowers](https://github.com/obra/superpowers) — powers Codeg's expert skills module - [OfficeCLI](https://github.com/iOfficeAI/OfficeCLI) — powers Codeg's Office documents workflow - [scientific-agent-skills](https://github.com/K-Dense-AI/scientific-agent-skills) — powers Codeg's Scientific Research skills (MIT-licensed subset) - [json-render](https://github.com/vercel-labs/json-render) — powers Codeg's UI Render cards, tables, and charts - [cua-driver](https://github.com/trycua/cua) — powers Codeg's Computer Use ## 📜 License Apache-2.0. See [LICENSE](./LICENSE).