MCPcopy
hub / github.com/xintaofei/codeg

github.com/xintaofei/codeg @v0.18.8 sqlite

repository ↗ · DeepWiki ↗ · release v0.18.8 ↗
3,919 symbols 10,898 edges 629 files 185 documented · 5%
README

Codeg

Release License Tauri Next.js Docker

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

Codeg (Code Generation) is a multi-agent coding workspace. It brings multiple agents (Claude Code, Codex CLI, OpenCode, Gemini CLI, OpenClaw, Cline, Hermes Agent, CodeBuddy, Kimi Code, Pi, etc.) into one workspace, supporting conversation aggregation and multi-agent collaboration, with desktop installation plus server/Docker deployment.

gallery

Sponsors

MyClaw.ai — Your OpenClaw Agent, Always On. MyClaw.ai — A fully managed OpenClaw cloud platform with one-click setup, 24/7 uptime, and full data ownership — no server management required.
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!

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

Main Interface

Codeg Light Codeg Dark

Multi-Agent Collaboration

Codeg Light Codeg Dark

Office Workflow

Codeg Light Codeg Dark

Highlights

  • Conversation Aggregation — import sessions from all supported agents into one unified workspace
  • Multi-Agent Collaboration — within a single session, the main agent delegates to sub-agents of different types (e.g. Claude Code calling Codex, Gemini) to jointly complete a task, each running as an independent session
  • Parallel development with built-in git worktree flows
  • Project Boot — visually scaffold new projects with live preview
  • Office Documents — create, analyze, proofread, and edit .docx / .xlsx / .pptx through the bundled officecli toolset, with live in-tab preview that refreshes as the agent edits
  • Automations — save a composer setup as a reusable automation that runs headlessly, on a cron schedule or on demand
  • Chat Channels — connect Telegram, Lark (Feishu), iLink (Weixin) and more to your coding agents for real-time notifications, full session interaction, and remote task control
  • MCP management (local scan + registry search/install)
  • Skills management (global and project scope)
  • Git remote account management (GitHub and other Git servers)
  • Web service mode — access Codeg from any browser for remote work
  • Standalone server deployment — run codeg-server on any Linux/macOS server, access via browser
  • Docker supportdocker compose up or docker run, with custom token, port, and volume mounts for data persistence and project directories
  • Runtime Logs — a live in-app log viewer with filtering and per-module log levels
  • Integrated engineering loop (file tree, diff, git changes, commit, terminal)

Supported Agents

Agent Environment Variable Path macOS / Linux Default Windows Default
Claude Code $CLAUDE_CONFIG_DIR/projects ~/.claude/projects %USERPROFILE%\\.claude\\projects
Codex CLI $CODEX_HOME/sessions ~/.codex/sessions %USERPROFILE%\\.codex\\sessions
OpenCode $XDG_DATA_HOME/opencode/opencode.db ~/.local/share/opencode/opencode.db %USERPROFILE%\\.local\\share\\opencode\\opencode.db
Gemini CLI $GEMINI_CLI_HOME/.gemini ~/.gemini %USERPROFILE%\\.gemini
OpenClaw ~/.openclaw/agents %USERPROFILE%\\.openclaw\\agents
Cline $CLINE_DIR ~/.cline/data/tasks %USERPROFILE%\\.cline\\data\\tasks
Hermes Agent $HERMES_HOME/state.db ~/.hermes/state.db %USERPROFILE%\\.hermes\\state.db
CodeBuddy $CODEBUDDY_CONFIG_DIR/projects ~/.codebuddy/projects %USERPROFILE%\\.codebuddy\\projects
Kimi Code $KIMI_CODE_HOME/sessions ~/.kimi-code/sessions %USERPROFILE%\\.kimi-code\\sessions
Pi $PI_CODING_AGENT_SESSION_DIR ~/.pi/agent/sessions %USERPROFILE%\\.pi\\agent\\sessions

Note: environment variables take precedence over fallback paths.

Project Boot

Create new projects visually with a split-pane interface: configure on the left, preview in real time on the right.

Project Boot Light Project Boot Dark

What it does

  • Visual Configuration — pick style, color theme, icon library, font, border radius, and more from dropdowns; the preview iframe updates instantly
  • Live Preview — see your chosen look & feel rendered in real time before creating anything
  • One-Click Scaffolding — hit "Create Project" and the launcher runs shadcn init with your preset, framework template (Next.js / Vite / React Router / Astro / Laravel), and package manager of choice (pnpm / npm / yarn / bun)
  • Package Manager Detection — automatically checks which package managers are installed and shows their versions
  • Seamless Integration — the newly created project opens in Codeg's workspace right away

Currently supports shadcn/ui project scaffolding, with a tab-based design ready for more project types in the future.

Chat Channels

Connect your favorite messaging apps — Telegram, Lark (Feishu), iLink (Weixin), and more — to your AI coding agents. Create tasks, send follow-up messages, approve permissions, resume sessions, and monitor activity — all from your chat app. Receive real-time agent responses with tool-call details, permission prompts, and completion summaries without ever opening a browser.

Supported Channels

Channel Protocol Status
Telegram Bot API (HTTP long-polling) Built-in
Lark (Feishu) WebSocket + REST API Built-in
iLink (Weixin) WebSocket + REST API Built-in

More channels (Discord, Slack, DingTalk, etc.) are planned for future releases.

Office Documents

Work with Word, Excel, and PowerPoint files as a first-class workflow. The bundled officecli toolset lets your agents create, analyze, proofread, and edit .docx, .xlsx, and .pptx documents — and you can preview the result right inside Codeg.

What it does

  • Create & Edit — generate new documents or modify existing .docx / .xlsx / .pptx files, including charts, tables, and formatting
  • Analyze & Proofread — inspect document structure, surface formatting issues, and proofread content
  • Live Preview — open a .docx / .xlsx / .pptx in a file tab and it renders inline, refreshing automatically as the agent edits — backed by a long-lived officecli watch server (reverse-proxied and capability-authenticated so it works in web and standalone-server deployments)
  • Quick Actions — the welcome page offers Coding and Office tabs that drop the matching skill invocation and a prompt template into the composer with one click; a skill that isn't enabled for the selected agent shows a lock badge linking to where you can turn it on
  • Office Tools settings — a dedicated settings page installs officecli and manages its document skills through a skill-by-agent matrix: toggle any (skill, agent) pair, flip a skill across all agents or every skill for one agent, and apply bulk changes at once

Automations

Turn any composer setup — agent, model, prompt, working directory, and options — into a reusable Automation that runs without opening the UI.

What it does

  • Save once, reuse — capture a fully-configured composer as a named, reusable automation
  • Scheduled or on demand — run it on a cron schedule or trigger it manually whenever you need it
  • Headless execution — automations run in the background and create real sessions you can open in the workspace at any time, then return you straight to the workspace when you start one

Quick Start

Requirements

  • Node.js >=22 (recommended)
  • pnpm >=10
  • Rust stable (2021 edition)
  • Tauri 2 build dependencies (desktop mode only)

Linux (Debian/Ubuntu) example:

sudo apt-get update
sudo apt-get install -y \
  libwebkit2gtk-4.1-dev \
  libayatana-appindicator3-dev \
  librsvg2-dev \
  patchelf

Binaries

Codeg ships three Rust binaries from a single workspace:

Binary Role Build
codeg Tauri desktop app (window, tray, updater) pnpm tauri build (release) / pnpm tauri dev (dev)
codeg-server Standalone HTTP + WebSocket server for browser/headless deployments pnpm server:build / pnpm server:dev
codeg-mcp Per-launch stdio MCP companion that surfaces the delegate_to_agent tool to agent CLIs (multi-agent collab) pnpm tauri:prepare-sidecars (auto-invoked by tauri dev / tauri build)

codeg-mcp must sit next to its parent binary at runtime — installers, the Docker image, and the Tauri sidecar bundler all place it next to codeg / codeg-server. Source builds and custom layouts can override the lookup with the CODEG_MCP_BIN=/abs/path/codeg-mcp env var. If the companion is missing, delegation is skipped (a single warning is logged) and the rest of the agent session keeps working.

Development

```bash pnpm install

Frontend only (Next.js dev server, no Rust)

pnpm dev

Frontend static export to out/

pnpm build

Full desktop app (Tauri + Next.js, builds codeg-mcp sidecar automatically)

pnpm tauri dev

Desktop release build (bundles codeg-mcp as externalBin)

pnpm tauri build

Standalone server (no Tauri/GUI required)

pnpm server:dev pnpm server:build # release binary at src-tauri/target/release/codeg-server

Build the codeg-mcp companion explicitly (for the host triple)

pnpm tauri:prepare-sidecars # output: src-tauri/binaries/codeg-mcp-

Skip sidecar prep when iterating on the frontend and you don't need delegation

CODEG_SKIP_SIDECAR=1 pnpm tauri dev

Lint

pnpm eslint .

Frontend tests (vitest)

pnpm test pnpm test:watch pnpm test:coverage

Rust checks (run in src-tauri/)

cargo check # desktop (default features) cargo check --no-default-features --bin codeg-server # server mode cargo check --no-default-features --bin codeg-mcp # MCP companion cargo clippy --all-targets --features test-utils -- -D warnings

Rust tests

Extension points exported contracts — how you extend this code

Transport (Interface)
(no doc) [5 implementers]
src/lib/transport/types.ts
EditOp (Interface)
* Backtrack the LCS table to produce edit operations. * Returns an array of { type, aIdx, bIdx } entries.
src/components/merge/merge-diff.ts
AppConfig (Interface)
(no doc)
src/i18n/global.d.ts
FolderLoadState (Interface)
(no doc)
src/app/merge/page.tsx
Task (Interface)
(no doc)
src/contexts/task-context.tsx
SwitchToBranchArgs (Interface)
(no doc)
src/hooks/use-switch-to-branch.ts
PersistedDraftStateV2 (Interface)
v2 draft payload: the composer's Tiptap document (preserves reference badges, * which a Markdown round-trip would down
src/lib/message-input-draft.ts
MarkedBlockToken (Interface)
The subset of a `marked` block token we inspect (structurally typed to avoid * a direct `marked` dependency). A `list`
src/components/chat/composer/markdown-insert.ts

Core symbols most depended-on inside this repo

cn
called by 430
src/lib/utils.ts
getTransport
called by 337
src/lib/transport/index.ts
call
called by 334
src/lib/transport/types.ts
toErrorMessage
called by 185
src/lib/app-error.ts
isDesktop
called by 62
src/lib/transport/index.ts
acpText
called by 46
src/components/settings/acp-agent-settings.tsx
languageFromPath
called by 44
src/lib/language-detect.ts
isAgentLikeToolName
called by 44
src/lib/adapters/tool-kind-classifier.ts

Shape

Function 3,137
Interface 637
Method 115
Class 30

Languages

TypeScript100%
Python1%

Modules by API surface

src/lib/api.ts338 symbols
src/lib/tauri.ts157 symbols
src/lib/types.ts154 symbols
src/components/settings/acp-agent-settings.tsx105 symbols
src/contexts/acp-connections-context.tsx70 symbols
src/lib/adapters/ai-elements-adapter.ts64 symbols
src/components/message/content-parts-renderer.tsx62 symbols
src/contexts/workspace-context.test.tsx43 symbols
src/components/files/file-workspace-panel.tsx42 symbols
src/lib/session-files.ts41 symbols
src-tauri/experts/skills/brainstorming/scripts/server.cjs39 symbols
src/components/layout/aux-panel-file-tree-tab.tsx36 symbols

Dependencies from manifests, versioned

@base-ui/react1.1.0 · 1×
@fontsource-variable/fira-code5.2.7 · 1×
@fontsource-variable/geist5.2.9 · 1×
@fontsource-variable/geist-mono5.2.8 · 1×
@fontsource-variable/jetbrains-mono5.2.8 · 1×
@monaco-editor/react4.7.0 · 1×
@radix-ui/react-use-controllable-state1.2.2 · 1×
@streamdown/cjk1.0.2 · 1×
@streamdown/code1.0.2 · 1×
@streamdown/math1.0.2 · 1×

For agents

$ claude mcp add codeg \
  -- python -m otcore.mcp_server <graph>

⬇ download graph artifact