Skip to content
/

codeg

codeg · xintaofei/codeg · ★ 1.3k · last commit 2026-05-26

Unifies multiple heterogeneous AI coding agents into one desktop workspace with session aggregation and cross-agent delegation.

Best whenDifferent AI coding agents have different strengths; teams should use all of them in one workflow rather than committing to one.
Skip ifSingle-agent-only workflow when multiple agent types could collaborate
vs seeds
claude-flow's agents are all Claude Code instances whi…
Primitive shape 6 total
Subagents 6
00

Summary

Codeg — Summary

Codeg (Code Generation) is a multi-agent coding workspace that unifies multiple AI coding agents — Claude Code, Codex CLI, OpenCode, Gemini CLI, OpenClaw, Cline, and others — into a single desktop and server application. It aggregates conversation sessions from all supported agents into one workspace, enables multi-agent collaboration (a main agent delegates subtasks to specialized sub-agents that each run as independent sessions), and provides a visual project bootstrapping interface, built-in git worktree flows, MCP management, and skills management at both global and project scopes. Codeg ships as a Tauri 2 desktop application (Rust backend + Next.js frontend) and as a standalone server binary (codeg-server) deployable via Docker on any Linux/macOS server, accessible from any browser. Chat channel integrations (Telegram, Lark/Feishu, iLink/Weixin) allow controlling agent sessions remotely from messaging apps.

Among the seeds, Codeg most closely resembles claude-flow in providing multi-agent orchestration, but differs in that Codeg is a UI workspace rather than an SDK or command-pack: it provides a visual interface for launching and monitoring agent sessions, while claude-flow provides programmatic multi-agent APIs. Codeg is also distinguished by being the only framework in this batch that aggregates across heterogeneous agent types (not just Claude), treating agent-type diversity as a first-class feature.

01

Overview

Codeg — Overview

Origin

Codeg is authored by xintaofei (GitHub: xintaofei/codeg), published in 2025-2026. Written in TypeScript (Next.js frontend) + Rust (Tauri 2 backend). Reached 1,344 stars as of 2026-05-26 and is actively maintained. Sponsored by Compshare (UCloud) and MyClaw.ai.

Philosophy

The README describes the project as "a multi-agent coding workspace [that] brings multiple agents into one workspace, supporting conversation aggregation and multi-agent collaboration." The philosophy is agent-type agnosticism: rather than being opinionated about which AI coding agent is best, Codeg acts as a universal workspace that works with all of them.

Key Differentiators (from README 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"

"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"

Target Users

  • Developers who use multiple AI coding tools and want a unified workspace
  • Teams wanting to delegate subtasks across agent types
  • Remote developers who want to control agent sessions via mobile messaging apps

Language Support

Full internationalization (next-intl). README available in 10 languages: English, 简体中文, 繁體中文, 日本語, 한국어, Español, Deutsch, Français, Português, العربية.

02

Architecture

Codeg — Architecture

Distribution

  • Tauri 2 desktop app (macOS, Windows, Linux)
  • Standalone server binary codeg-server (Linux/macOS)
  • Docker: docker compose up or docker run

Required Runtime

  • No runtime dependencies for end users (Tauri bundles Rust binary)
  • For server mode: Docker or direct binary
  • For development: pnpm + Rust + Node.js

Tech Stack

Layer Technology
Desktop runtime Tauri 2 (Rust backend + webview)
Server binary Rust (Axum HTTP + WebSocket)
Frontend Next.js 16 (static export) + React 19 + TypeScript (strict)
Styling Tailwind CSS v4 + shadcn/ui
Internationalization next-intl
Database SeaORM + SQLite
Package manager pnpm

Repository Structure

codeg/
├── src/                    # Next.js frontend
├── src-tauri/              # Rust/Tauri backend
├── .cargo/                 # Rust configuration
├── public/                 # Static assets
├── CLAUDE.md               # Development guidance (Chinese)
├── docs/images/            # Screenshots
└── docker-compose.yml      # Docker deployment

Supported Agent Session Sources

Agent Session Storage
Claude Code $CLAUDE_CONFIG_DIR/projects or ~/.claude/projects
Codex CLI $CODEX_HOME/sessions or ~/.codex/sessions
OpenCode $XDG_DATA_HOME/opencode/opencode.db
Gemini CLI $GEMINI_CLI_HOME/.gemini or ~/.gemini
OpenClaw ~/.openclaw/agents
Cline $CLINE_DIR or ~/.cline/data/tasks

Web Service Mode

The codeg-server binary runs Codeg as a web service on any Linux/macOS server. Users access it from any browser. Supports custom token, port, and volume mounts via Docker.

03

Components

Codeg — Components

Core Features (UI Modules)

Feature Description
Conversation Aggregation Import and unify sessions from all supported agents in one workspace
Multi-Agent Collaboration Main agent delegates to typed sub-agents, each as independent sessions
Project Boot Visual scaffolding of new projects with live preview (shadcn/ui + Next.js/Vite/Astro/Laravel/React Router)
Git Worktree Flows Built-in parallel development via git worktrees
MCP Management Local scan + registry search/install for MCP servers
Skills Management Global and project-scoped skills management
Chat Channels Telegram, Lark (Feishu), iLink (Weixin) integration
Engineering Loop Integrated file tree, diff viewer, git changes, commit, terminal
Web Service Mode Access Codeg from any browser; codeg-server binary

Multi-Agent Collaboration Architecture

Main Agent Session (e.g., Claude Code)
    │
    ├── Sub-Agent 1: Codex (implements backend task)
    ├── Sub-Agent 2: Gemini (implements frontend task)
    └── Sub-Agent 3: Claude Code (code review)

Each sub-agent runs as an independent session. The main agent coordinates via delegation.

Project Boot Options

Visual scaffolding supports:

  • Frameworks: Next.js, Vite, React Router, Astro, Laravel
  • Package managers: pnpm, npm, yarn, bun
  • UI toolkit: shadcn/ui (with live preview of color theme, border radius, icon library, font)

Database

SQLite via SeaORM — stores session metadata, MCP registrations, and skills configurations.

05

Prompts

Codeg — Prompts

Codeg is a workspace application, not a prompt engineering framework. It does not ship SKILL.md files or agent behavioral prompts. The CLAUDE.md is a Chinese-language contributor guide for the Codeg codebase itself.

Excerpt 1 — CLAUDE.md Development Guide (Translated)

# CLAUDE.md

This file provides guidance to Claude Code when working with code in this repository.

## Project Overview

Codeg is a multi-agent coding workspace that unifies multiple agents (Claude Code, Codex CLI, 
OpenCode, Gemini CLI, OpenClaw, Cline, etc.) into one workspace, supporting session aggregation 
and multi-agent collaboration. Supports desktop installation, server/Docker deployment.

## Tech Stack
- Desktop runtime: Tauri 2 (Rust backend + webview)
- Server runtime: Standalone Rust binary (Axum HTTP + WebSocket)
- Frontend: Next.js 16 (static export) + React 19 + TypeScript (strict)
- Styling: Tailwind CSS v4 + shadcn/ui
- Internationalization: next-intl
- Database: SeaORM + SQLite
- Package manager: pnpm

## Linting & Testing (run after completing tasks)

### Frontend
pnpm eslint .              # lint
pnpm test                  # vitest full run
pnpm test:watch            # incremental watch for development
pnpm test:coverage         # coverage report
pnpm build                 # static export build

### Backend Rust (in src-tauri/ directory)
cargo check
cargo test --features test-utils
cargo clippy --all-targets --features test-utils -- -D warnings

Prompting technique: Bilingual contributor guide. The CLAUDE.md is written in Chinese (the author's primary language), using Claude Code as a Chinese-speaking contributor to the project. The file specifies exact test commands for both frontend and backend layers, treating Claude as a contributor who must follow CI conventions.

Excerpt 2 — Multi-Agent Delegation Pattern (from README)

The README describes multi-agent collaboration as:

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

Prompting technique: Hierarchical delegation without prescribed prompts. Codeg enables the pattern without specifying the delegation prompt format — the main agent decides when and how to delegate. This is infrastructure for delegation, not a prescribed delegation protocol.

Excerpt 3 — Project Boot Prompt Pattern

The Project Boot feature uses a visual configuration interface (color theme, icon library, font, border radius) to generate a shadcn init command with the user's chosen preset. The resulting command is:

npx shadcn@latest init --style=<style> --base-color=<color> --css-variables=true

Prompting technique: Visual-to-command translation. User preferences are collected visually, then translated into a precise CLI command for scaffolding. No LLM prompt engineering is involved — this is UI-driven command generation.

09

Uniqueness

Codeg — Uniqueness

Differs from Seeds

Codeg is the only framework in the corpus that provides a universal multi-agent workspace spanning heterogeneous agent types. All seeds focus on enhancing a single agent type (Claude Code primarily). Codeg treats Claude Code, Codex, Gemini CLI, OpenCode, OpenClaw, and Cline as peer workers that can be delegated to within a single workflow — a main Claude Code session can spawn a Codex sub-session and a Gemini sub-session in the same task. This cross-agent delegation pattern is absent from all 11 seeds. Claude-flow is the closest seed in spirit (hierarchical multi-agent orchestration), but claude-flow's agents are all Claude Code instances; Codeg's agents span heterogeneous types with different LLM backends. The Chat Channels integration (Telegram, Lark, iLink) for remote session control via mobile messaging is also unique in the corpus. Codeg's git worktree support resembles superpowers and claude-flow, but is surfaced in a desktop GUI rather than CLI skill invocations.

Positioning

Codeg is an "AI coding fleet manager" — a workspace that treats multiple AI agents as a workforce to be dispatched and monitored. The value proposition is: every major AI coding agent has a different strength; Codeg lets a team use all of them in one workflow. It is not opinionated about how agents should work (no spec format, no TDD enforcement, no quality gates) — it provides the environment, not the methodology.

Observable Failure Modes

  1. Coordination relies on the main agent: If the main agent's delegation logic fails (e.g., incorrect prompt to spawn sub-agents), sub-agent work is disconnected from the goal.
  2. No shared context between agents: Sub-agents in different session types (Codex, Gemini) don't natively share Claude Code's context or memory. Coordination is coarse-grained.
  3. Agent-type version drift: When Claude Code, Codex, or Gemini update their session formats, Codeg's session reader may break.
  4. No conflict detection: Unlike Asynkor, Codeg has no mechanism to prevent two agents from editing the same file simultaneously in a multi-agent session.
04

Workflow

Codeg — Workflow

Primary Workflow: Multi-Agent Development Session

Phase Action Artifact
1. Bootstrap Project Boot: visual scaffolding Initialized project directory
2. Assign Launch main agent session (e.g., Claude Code) Active agent session
3. Delegate Main agent spawns sub-agents for parallel tasks Multiple independent sub-sessions
4. Monitor Watch sessions in unified workspace Live conversation feed
5. Commit Use built-in git changes + commit interface Git commit
6. Notify Receive updates via Telegram/Lark/iLink Remote notifications

Parallel Development Workflow (Git Worktrees)

  1. Open Codeg workspace
  2. Launch multiple agent sessions, each in its own git worktree
  3. Each worktree/session works on a separate feature branch simultaneously
  4. Monitor all sessions from one dashboard

Session Aggregation Workflow

  1. Codeg scans configured agent session directories at startup
  2. All historical sessions appear in unified timeline
  3. User can open any session, view conversation, resume interaction

Approval Gates

None imposed by Codeg — agents operate autonomously. User can interact via chat channels for remote approval.

Chat Channel Control

Via Telegram/Lark/iLink:

  • Receive real-time notifications about session activity
  • Send messages to agent sessions remotely
  • Full session interaction from mobile
  • Remote task control (start, stop, query session state)
06

Memory Context

Codeg — Memory & Context

State Storage

State Type Storage Persistence
Session history SQLite (via SeaORM) Project-level
MCP server registrations SQLite Project-level
Skills configurations SQLite Global + project
Agent session transcripts Reads from agent-native locations Per-agent
Git history Git Project-level

Session Aggregation Memory

Codeg reads session transcripts from agent-native storage paths (Claude Code's ~/.claude/projects, Codex's ~/.codex/sessions, etc.) and indexes them in its local SQLite database. This enables unified search and browsing across all historical sessions regardless of which agent produced them.

Cross-Session Handoff

Via SQLite — session metadata persists between Codeg restarts. The user can resume any previous session.

Skills Memory

Skills are managed at two scopes:

  • Global scope: available across all projects
  • Project scope: specific to the current workspace

Codeg tracks installed and active skills in SQLite.

Context Compaction

Not a Codeg concern — the individual agents (Claude Code, Codex, etc.) handle context compaction according to their own mechanisms.

Memory Type

sqlite — all Codeg-managed state (sessions, MCP registrations, skills) lives in a local SQLite database. Agent-native session transcripts are read-only from their original locations.

07

Orchestration

Codeg — Orchestration

Multi-Agent

Yes. Codeg explicitly supports multi-agent collaboration: a main agent session can delegate subtasks to sub-agents of different types (Claude Code → Codex, Gemini, etc.), each running as an independent session.

Orchestration Pattern

hierarchical — main agent acts as director, spawning typed sub-agents for parallel tasks. This is not peer-to-peer coordination; it is hub-and-spoke delegation.

Isolation Mechanism

git-worktree — parallel development uses built-in git worktree flows. Each feature/session can have its own worktree and branch.

Execution Mode

continuous-ralph / interactive-loop — Codeg is a persistent desktop/server application. Sessions run until stopped. Multi-agent sessions run in parallel.

Multi-Model

Yes — different sub-agents can use different LLM backends. A main Claude Code session can delegate to a Codex sub-agent (OpenAI models) and a Gemini sub-agent simultaneously. This is the most explicit multi-model orchestration in this batch.

Model Role Mapping

Role Agent Type
Main/Director User's choice (Claude Code, Codex, etc.)
Subtask executor Any supported agent type

Max Concurrent Agents

Unknown upper limit. The README mentions multiple simultaneous sessions as a primary use case.

Consensus Mechanism

None. Coordination is entirely hierarchical.

Cross-Tool Portability

High — Codeg is an abstraction layer over all supported agent types. It works with any of the six supported agents without preference.

08

Ui Cli Surface

Codeg — UI & CLI Surface

Dedicated CLI Binary

No user-facing CLI binary. The desktop app is the primary interface. The codeg-server is a server binary but not a CLI workflow tool.

Local Web Dashboard / Desktop App

Yes — Codeg is a desktop-first application:

Desktop app (Tauri 2): macOS, Windows, Linux native app

Server mode (codeg-server): Web interface accessible from any browser

UI Modules

Module Description
Session workspace Unified view of all agent sessions
Conversation aggregation Import + browse sessions from all agents
Multi-agent collaboration Delegate and monitor sub-agent sessions
Project Boot Visual project scaffolding with live preview
File tree Browse and navigate project files
Diff viewer Review changes before commit
Git changes Stage, unstage, and view modifications
Commit interface Create commits from within Codeg
Terminal Integrated terminal
MCP management Install/remove MCP servers (local scan + registry)
Skills management Global and project-level skills
Git remote accounts GitHub and other Git server authentication
Chat channels Telegram/Lark/iLink integration configuration

Web Service Mode

# Docker
docker compose up
docker run -e CODEG_TOKEN=xxx -p 8080:8080 codeg/server

# Binary
codeg-server --port 8080 --token xxx

Access from any browser. Supports custom port, token, and volume mounts for data persistence and project directories.

Observability

  • Integrated conversation history (all sessions visible in unified timeline)
  • No explicit audit log beyond session transcripts

Related frameworks

same archetype · same primary tool · same memory type

Goose (Block/AAIF) ★ 46k

General-purpose AI agent (not just code) with security-first tool inspection, recipe-based shareable configurations, and 15+ LLM…

Vibe Kanban ★ 27k

Eliminate the overhead of planning, switching between agent terminals, and reviewing diffs by providing a single web dashboard…

1Code ★ 5.5k

Cursor-like desktop experience for Claude Code and Codex with cloud background agents, event-driven automations, and a full…

Crystal (stravu) ★ 3.1k

Manage multiple parallel AI coding sessions in isolated git worktrees from a single desktop GUI.

Maestro (RunMaestro) ★ 3.0k

Orchestrate unlimited parallel AI agent sessions with a keyboard-first desktop app including Group Chat coordination and Auto Run…

AgentsMesh ★ 2.1k

Multi-tenant workforce platform that gives every team member a squad of AI coding agents coordinated through channels, pod…