Codeg AI Agent

<h1 align="center"> <a href="https://docs.codeg.app"><img src="./public/icon.svg" alt="Codeg logo" width="64" align="absmiddle" /></a> Codeg </h1> <p align="center"> <a href="https://github.com/spacering-net/codeg"><img src="https://img.shields.io/github/stars/spacering-net/codeg?style=flat&color=e91e63" alt="GitHub stars" /></a> <a href="https://github.com/spacering-net/codeg/releases/latest"><img src="https://img.shields.io/github/v/release/spacering-net/codeg?style=flat&color=e91e63" alt="Latest release" /></a> <a href="https://github.com/spacering-net/codeg/releases"><img src="https://img.shields.io/github/downloads/spacering-net/codeg/total?style=flat&color=e91e63" alt="Total downloads" /></a> <a href="./LICENSE"><img src="https://img.shields.io/github/license/spacering-net/codeg?style=flat&color=e91e63" alt="License" /></a> <a href="https://docs.codeg.app"><img src="https://img.shields.io/badge/docs-docs.codeg.app-3451b2?style=flat" alt="Documentation" /></a> <a href="https://docs.codeg.app/getting-started/installation"><img src="https://img.shields.io/badge/macOS%20%7C%20Windows%20%7C%20Linux%20%7C%20Docker%20%7C%20iOS%20%7C%20Android-03a9f4?style=flat" alt="Platforms: macOS, Windows, Linux, Docker, iOS, Android" /></a> </p> <p align="center"> _{<strong>English</strong> · <a href="./docs/readme/README.zh-CN.md">简体中文</a> · <a href="./docs/readme/README.zh-TW.md">繁體中文</a> · <a href="./docs/readme/README.ja.md">日本語</a> · <a href="./docs/readme/README.ko.md">한국어</a> · <a href="./docs/readme/README.es.md">Español</a> · <a href="./docs/readme/README.de.md">Deutsch</a> · <a href="./docs/readme/README.fr.md">Français</a> · <a href="./docs/readme/README.pt.md">Português</a> · <a href="./docs/readme/README.ar.md">العربية</a>} </p> <p align="center"> <strong>The multi-agent coding workspace.</strong><br/> Run every AI coding agent in one place — and let them work together. </p> <h3 align="center"><a href="https://github.com/spacering-net/codeg/releases/latest"><ins>Download Codeg</ins></a> · <a href="https://docs.codeg.app"><ins>Documentation</ins></a></h3> <p align="center"> <picture> <source media="(prefers-color-scheme: dark)" srcset="./docs/images/workspace-dark.png" /> <img src="./docs/images/workspace-light.png" alt="The Codeg workspace: a conversation with an agent beside its live diffs and the project's files" width="960" /> </picture> </p> <table> <tr> <td width="50%" valign="top">🧩 <strong>One interface for every agent</strong><br/>Twenty agents built in, and any ACP agent can join — all rendered as the same structured conversation, not a terminal.</td> <td width="50%" valign="top">🔎 <strong>Sessions that travel</strong><br/>Import, search, and resume the history every agent keeps on disk, then hand it to a different agent.</td> </tr> <tr> <td width="50%" valign="top">🤝 <strong>Agents that work together</strong><br/>Delegate across agents with an <code>@</code>, or queue to-dos that run unattended in their own worktrees.</td> <td width="50%" valign="top">🌍 <strong>Wherever you work</strong><br/>Desktop app, self-hosted server or Docker, iPhone, iPad, and Android — and Telegram, Lark, or WeChat.</td> </tr> </table>

✨ Features

<table> <tr> <td width="50%" valign="middle">

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 →

</td> <td width="50%"> <picture> <source media="(prefers-color-scheme: dark)" srcset="./docs/images/features/agents-dark.gif" /> <img src="./docs/images/features/agents-light.gif" alt="One Interface for Every Agent" width="100%" /> </picture> </td> </tr> <tr> <td width="50%" valign="middle">

Every Session, Searchable

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

Docs → · Tags →

</td> <td width="50%"> <picture> <source media="(prefers-color-scheme: dark)" srcset="./docs/images/features/sessions-dark.gif" /> <img src="./docs/images/features/sessions-light.gif" alt="Every Session, Searchable" width="100%" /> </picture> </td> </tr> <tr> <td width="50%" valign="middle">

Multi-Agent Collaboration

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

Docs →

</td> <td width="50%"> <picture> <source media="(prefers-color-scheme: dark)" srcset="./docs/images/features/multi-agent-dark.gif" /> <img src="./docs/images/features/multi-agent-light.gif" alt="Multi-Agent Collaboration" width="100%" /> </picture> </td> </tr> <tr> <td width="50%" valign="middle">

To-dos That Run Unattended

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

Docs → · Auto-processing →

</td> <td width="50%"> <picture> <source media="(prefers-color-scheme: dark)" srcset="./docs/images/features/todos-dark.gif" /> <img src="./docs/images/features/todos-light.gif" alt="To-dos That Run Unattended" width="100%" /> </picture> </td> </tr> <tr> <td width="50%" valign="middle">

Infinite Canvas

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

Docs →

</td> <td width="50%"> <picture> <source media="(prefers-color-scheme: dark)" srcset="./docs/images/features/canvas-dark.gif" /> <img src="./docs/images/features/canvas-light.gif" alt="Infinite Canvas" width="100%" /> </picture> </td> </tr> <tr> <td width="50%" valign="middle">

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 →

</td> <td width="50%"> <picture> <source media="(prefers-color-scheme: dark)" srcset="./docs/images/features/anywhere-dark.gif" /> <img src="./docs/images/features/anywhere-light.gif" alt="Desktop, Server, Mobile & Chat" width="100%" /> </picture> </td> </tr> <tr> <td width="50%" valign="middle">

Office Documents & Research

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

Docs → · Research →

</td> <td width="50%"> <picture> <source media="(prefers-color-scheme: dark)" srcset="./docs/images/features/office-dark.gif" /> <img src="./docs/images/features/office-light.gif" alt="Office Documents & Research" width="100%" /> </picture> </td> </tr> <tr> <td width="50%" valign="middle">

Browser & Computer Use

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

Docs → · Computer Use →

</td> <td width="50%"> <picture> <source media="(prefers-color-scheme: dark)" srcset="./docs/images/features/browser-dark.gif" /> <img src="./docs/images/features/browser-light.gif" alt="Browser & Computer Use" width="100%" /> </picture> </td> </tr> <tr> <td width="50%" valign="middle">

Command Line & CI

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

Docs →

</td> <td width="50%" valign="middle">

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

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

</td> </tr> </table>

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:

<p> <a href="https://www.anthropic.com/claude-code"><kbd><img src="./docs/images/agents/claude-code.svg" alt="" width="16" valign="middle" /> Claude Code</kbd></a> &nbsp; <a href="https://github.com/openai/codex"><kbd><img src="./docs/images/agents/codex.svg" alt="" width="16" valign="middle" /> Codex</kbd></a> &nbsp; <a href="https://github.com/google-gemini/gemini-cli"><kbd><img src="./docs/images/agents/gemini-cli.svg" alt="" width="16" valign="middle" /> Gemini CLI</kbd></a> &nbsp; <a href="https://openclaw.ai"><kbd><img src="./docs/images/agents/openclaw.svg" alt="" width="16" valign="middle" /> OpenClaw</kbd></a> &nbsp; <a href="https://opencode.ai"><kbd><picture><source media="(prefers-color-scheme: dark)" srcset="./docs/images/agents/opencode-dark.svg" /><img src="./docs/images/agents/opencode.svg" alt="" width="16" valign="middle" /></picture> OpenCode</kbd></a> &nbsp; <a href="https://cline.bot"><kbd><picture><source media="(prefers-color-scheme: dark)" srcset="./docs/images/agents/cline-dark.svg" /><img src="./docs/images/agents/cline.svg" alt="" width="16" valign="middle" /></picture> Cline</kbd></a> &nbsp; <a href="https://hermes-agent.nousresearch.com"><kbd><picture><source media="(prefers-color-scheme: dark)" srcset="./docs/images/agents/hermes-agent-dark.svg" /><img src="./docs/images/agents/hermes-agent.svg" alt="" width="16" valign="middle" /></picture> Hermes Agent</kbd></a> &nbsp; <a href="https://www.codebuddy.ai"><kbd><picture><source media="(prefers-color-scheme: dark)" srcset="./docs/images/agents/codebuddy-dark.svg" /><img src="./docs/images/agents/codebuddy.svg" alt="" width="16" valign="middle" /></picture> CodeBuddy</kbd></a> &nbsp; <a href="https://www.kimi.com/code"><kbd><img src="./docs/images/agents/kimi-code.svg" alt="" width="16" valign="middle" /> Kimi Code</kbd></a> &nbsp; <a href="./docs/agents/minimax-code.md"><kbd><img src="./docs/images/agents/minimax-code.svg" alt="" width="16" valign="middle" /> MiniMax Code</kbd></a> &nbsp; <a href="https://pi.dev"><kbd><img src="./docs/images/agents/pi.svg" alt="" width="16" valign="middle" /> Pi</kbd></a> &nbsp; <a href="https://x.ai/cli"><kbd><picture><source media="(prefers-color-scheme: dark)" srcset="./docs/images/agents/grok-dark.svg" /><img src="./docs/images/agents/grok.svg" alt="" width="16" valign="middle" /></picture> Grok</kbd></a> &nbsp; <a href="https://cursor.com/cli"><kbd><picture><source media="(prefers-color-scheme: dark)" srcset="./docs/images/agents/cursor-dark.svg" /><img src="./docs/images/agents/cursor.svg" alt="" width="16" valign="middle" /></picture> Cursor</kbd></a> &nbsp; <a href="https://deepseek-harness.github.io/deepseek-harness/"><kbd><img src="./docs/images/agents/deepseek-harness.svg" alt="" width="16" valign="middle" /> DeepSeek Harness</kbd></a> &nbsp; <a href="https://qoder.com"><kbd><picture><source media="(prefers-color-scheme: dark)" srcset="./docs/images/agents/qoder-dark.svg" /><img src="./docs/images/agents/qoder.svg" alt="" width="16" valign="middle" /></picture> Qoder</kbd></a> &nbsp; <a href="https://antigravity.google"><kbd><picture><source media="(prefers-color-scheme: dark)" srcset="./docs/images/agents/google-antigravity-dark.svg" /><img src="./docs/images/agents/google-antigravity.svg" alt="" width="16" valign="middle" /></picture> Google Antigravity</kbd></a> &nbsp; <a href="https://kiro.dev/cli/"><kbd><img src="./docs/images/agents/kiro.svg" alt="" width="16" valign="middle" /> Kiro CLI</kbd></a> &nbsp; <a href="./docs/agents/zcode.md"><kbd><img src="./docs/images/agents/zcode.svg" alt="" width="16" valign="middle" /> ZCode</kbd></a> &nbsp; <a href="https://docs.trae.cn/cli_about-trae-code-cli-2"><kbd><img src="./docs/images/agents/trae.svg" alt="" width="16" valign="middle" /> TRAE CLI</kbd></a> &nbsp; <a href="https://commandcode.ai"><kbd><img src="./docs/images/agents/command-code.svg" alt="" width="16" valign="middle" /> Command Code</kbd></a> &nbsp; <a href="https://docs.codeg.app/guide/custom-agents"><kbd>+ any ACP agent</kbd></a> </p>

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:

  <picture> <source media="(prefers-color-scheme: dark)" srcset="./docs/images/weixin-dark.jpg" /> <img src="./docs/images/weixin-light.jpg" alt="WeChat" width="200" /> </picture>

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

<a href="https://github.com/spacering-net/codeg/graphs/contributors"> <img src="https://contrib.rocks/image?repo=spacering-net/codeg" alt="Codeg contributors" /> </a>

⭐ Star History

<a href="https://www.star-history.com/?repos=spacering-net%2Fcodeg&type=date&releases=&legend=bottom-right"> <picture> <source media="(prefers-color-scheme: dark)" srcset="https://api.star-history.com/chart?repos=spacering-net/codeg&type=date&theme=dark&legend=bottom-right" /> <source media="(prefers-color-scheme: light)" srcset="https://api.star-history.com/chart?repos=spacering-net/codeg&type=date&legend=bottom-right" /> <img alt="Star History Chart" src="https://api.star-history.com/chart?repos=spacering-net/codeg&type=date&legend=bottom-right" /> </picture> </a>

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