💖 Sponsors
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 →
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
🤖 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:
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
📜 License
Apache-2.0. See LICENSE.
