Codeg

Erstellen Sie neue Projekte visuell mit einer geteilten Oberfläche: links konfigurieren, rechts in Echtzeit Vorschau anzeigen.

Funktionen

• Visuelle Konfiguration — Stil, Farbthema, Icon-Bibliothek, Schrift, Rahmenradius und mehr über Dropdowns auswählen; die Vorschau aktualisiert sich sofort
• Live-Vorschau — das gewählte Look & Feel wird in Echtzeit gerendert, bevor etwas erstellt wird
• Ein-Klick-Erstellung — klicken Sie auf „Projekt erstellen" und der Launcher führt shadcn init mit Ihrem Preset, Framework-Template (Next.js / Vite / React Router / Astro / Laravel) und Paketmanager (pnpm / npm / yarn / bun) aus
• Paketmanager-Erkennung — prüft automatisch, welche Paketmanager installiert sind und zeigt ihre Versionen an
• Nahtlose Integration — das neu erstellte Projekt wird sofort im Codeg-Workspace geöffnet

Unterstützt derzeit shadcn/ui-Projekt-Scaffolding, mit einem Tab-basierten Design für zukünftige Projekttypen.

Verbinden Sie Ihre bevorzugten Messaging-Apps — Telegram, Lark (Feishu), iLink (Weixin) und mehr — mit Ihren KI-Coding-Agenten. Erstellen Sie Aufgaben, senden Sie Folgenachrichten, genehmigen Sie Berechtigungen, setzen Sie Sitzungen fort und überwachen Sie die Aktivität direkt aus dem Chat — empfangen Sie Echtzeit-Antworten der Agenten mit Tool-Call-Details, Berechtigungsanfragen und Abschlusszusammenfassungen, ohne einen Browser zu öffnen.

Unterstützte Kanäle

Weitere Kanäle (Discord, Slack, DingTalk usw.) sind für zukünftige Releases geplant.

Arbeiten Sie mit Word-, Excel- und PowerPoint-Dateien als erstklassigen Workflow. Das integrierte officecli-Toolset ermöglicht es Ihren Agenten, .docx-, .xlsx- und .pptx-Dokumente zu erstellen, zu analysieren, zu korrigieren und zu bearbeiten — und das Ergebnis direkt in Codeg zu prüfen.

Funktionen

• Erstellen und Bearbeiten — neue Dokumente generieren oder vorhandene .docx / .xlsx / .pptx-Dateien bearbeiten, einschließlich Diagramme, Tabellen und Formatierung
• Analysieren und Korrigieren — Dokumentstruktur prüfen, Formatierungsprobleme aufdecken und Inhalte korrigieren
• Live-Vorschau — öffnen Sie eine .docx / .xlsx / .pptx-Datei in einem Datei-Tab; sie wird inline gerendert und aktualisiert sich automatisch, wenn der Agent Änderungen vornimmt — unterstützt durch einen dauerhaft laufenden officecli watch-Server (mit Reverse-Proxy und Fähigkeits-Authentifizierung für Web- und Serverumgebungen)
• Schnellaktionen — die Willkommensseite bietet Tabs für Codierung und Office, die mit einem Klick den passenden Skill-Aufruf und eine Prompt-Vorlage in den Composer einfügen; nicht aktivierte Skills zeigen ein Schloss-Badge und verlinken zur Aktivierung
• Office-Tools-Einstellungen — eine dedizierte Einstellungsseite installiert officecli und verwaltet dessen Dokument-Skills über eine Skill×Agent-Matrix: beliebige (Skill, Agent)-Paare umschalten und Massenänderungen anwenden

Speichern Sie jede Composer-Konfiguration — Agent, Modell, Prompt, Arbeitsverzeichnis und Optionen — als wiederverwendbare Automatisierung, die ohne geöffnete Benutzeroberfläche ausgeführt wird.

Funktionen

• Einmal konfigurieren, immer wieder nutzen — vollständige Composer-Konfiguration als benannte Automatisierung speichern
• Geplant oder auf Abruf — nach Cron-Zeitplan oder manuell starten
• Headless-Ausführung — Automatisierungen laufen im Hintergrund und erzeugen echte Sitzungen, die jederzeit im Workspace geöffnet werden können; nach dem Start kehrt die Oberfläche automatisch in den Workspace zurück

Voraussetzungen

• Node.js >=22 (empfohlen)
• pnpm >=10
• Rust stable (2021 edition)
• Tauri-2-Build-Abhängigkeiten (nur Desktop-Modus)

Linux-Beispiel (Debian/Ubuntu):

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

Binärdateien

Codeg liefert drei Rust-Binärdateien aus einem einzigen Workspace:

codeg-mcp muss zur Laufzeit neben seiner übergeordneten Binärdatei liegen — Installer, das Docker-Image und der Tauri-Sidecar-Bundler legen ihn alle neben codeg / codeg-server ab. Quellcode-Builds und benutzerdefinierte Layouts können die Suche mit der Umgebungsvariablen CODEG_MCP_BIN=/abs/pfad/codeg-mcp überschreiben. Fehlt der Begleiter, wird die Delegation übersprungen (eine einzige Warnung wird protokolliert) und die restliche Agenten-Sitzung funktioniert weiter.

Entwicklung

pnpm install

# Nur Frontend (Next.js-Dev-Server, kein Rust)
pnpm dev

# Frontend-Statikexport nach out/
pnpm build

# Vollständige Desktop-App (Tauri + Next.js, baut codeg-mcp-Sidecar automatisch)
pnpm tauri dev

# Desktop-Release-Build (bündelt codeg-mcp als externalBin)
pnpm tauri build

# Standalone-Server (kein Tauri/GUI erforderlich)
pnpm server:dev
pnpm server:build                  # Release-Binary unter src-tauri/target/release/codeg-server

# codeg-mcp-Begleiter explizit bauen (für das Host-Triple)
pnpm tauri:prepare-sidecars        # Ausgabe: src-tauri/binaries/codeg-mcp-<triple>

# Sidecar-Vorbereitung überspringen, wenn am Frontend gearbeitet wird und keine Delegation benötigt wird
CODEG_SKIP_SIDECAR=1 pnpm tauri dev

# Lint
pnpm eslint .

# Frontend-Tests (vitest)
pnpm test
pnpm test:watch
pnpm test:coverage

# Rust-Prüfungen (in src-tauri/ ausführen)
cargo check                                                     # Desktop (Standard-Features)
cargo check --no-default-features --bin codeg-server            # Server-Modus
cargo check --no-default-features --bin codeg-mcp               # MCP-Begleiter
cargo clippy --all-targets --features test-utils -- -D warnings

# Rust-Tests
cargo test --features test-utils                                # Desktop (inkl. Integration)
cargo test --no-default-features --bin codeg-server --lib       # Server-Modus
cargo insta review                                              # Parser-Snapshot-Updates akzeptieren

Tipp: Wenn unter src-tauri/target/release/ ein frischer codeg-mcp-Build vorliegt und Sie einen manuell gestarteten codeg-server darauf zeigen lassen wollen, ohne ihn neu zu installieren, exportieren Sie CODEG_MCP_BIN=$(pwd)/src-tauri/target/release/codeg-mcp.

Server-Bereitstellung

Codeg kann als eigenständiger Webserver ohne Desktop-Umgebung betrieben werden.

Option 1: Ein-Zeilen-Installation (Linux / macOS)

curl -fsSL https://raw.githubusercontent.com/xintaofei/codeg/main/install.sh | bash

Eine bestimmte Version oder in ein benutzerdefiniertes Verzeichnis installieren:

curl -fsSL https://raw.githubusercontent.com/xintaofei/codeg/main/install.sh | bash -s -- --version v0.5.2 --dir ~/.local/bin

Dann ausführen:

codeg-server

Option 2: Ein-Zeilen-Installation (Windows PowerShell)

irm https://raw.githubusercontent.com/xintaofei/codeg/main/install.ps1 | iex

Oder eine bestimmte Version installieren:

.\install.ps1 -Version v0.5.2

Option 3: Von GitHub Releases herunterladen

Vorkompilierte Binärdateien (mit gebündelten Web-Assets) sind auf der Releases-Seite verfügbar:

# Beispiel: Herunterladen, Entpacken und Ausführen
tar xzf codeg-server-linux-x64.tar.gz
cd codeg-server-linux-x64
CODEG_STATIC_DIR=./web ./codeg-server

Option 4: Docker

# Mit Docker Compose (empfohlen)
docker compose up -d

# Oder direkt mit Docker ausführen
docker run -d -p 3080:3080 -v codeg-data:/data ghcr.io/xintaofei/codeg:latest

# Mit benutzerdefiniertem Token und Projektverzeichnis-Mount
docker run -d -p 3080:3080 \
  -v codeg-data:/data \
  -v /path/to/projects:/projects \
  -e CODEG_TOKEN=your-secret-token \
  ghcr.io/xintaofei/codeg:latest

Das Docker-Image verwendet einen Multi-Stage-Build (Node.js + Rust → schlanke Debian-Laufzeitumgebung) und enthält git und ssh für Repository-Operationen. Daten werden im /data-Volume persistent gespeichert. Optional können Projektverzeichnisse gemountet werden, um aus dem Container auf lokale Repositories zuzugreifen.

Option 5: Aus Quellcode kompilieren

pnpm install && pnpm build          # Frontend kompilieren
cd src-tauri
cargo build --release --bin codeg-server --no-default-features
cargo build --release --bin codeg-mcp --no-default-features    # Delegations-Begleiter
CODEG_STATIC_DIR=../out ./target/release/codeg-server          # codeg-mcp wird als Geschwisterdatei erkannt

Wenn Sie die beiden Binärdateien in getrennten Verzeichnissen halten, setzen Sie CODEG_MCP_BIN=/abs/pfad/zu/codeg-mcp, damit die Laufzeit den Begleiter dennoch findet; ohne diese Variable wird die Multi-Agent-Delegation stillschweigend deaktiviert.

Konfiguration

Umgebungsvariablen:

Next.js 16 (Static Export) + React 19
        |
        | invoke() (desktop) / fetch() + WebSocket (web)
        v
  ┌─────────────────────────┐
  │   Transport Abstraction  │
  │  (Tauri IPC or HTTP/WS) │
  └─────────────────────────┘
        |
        v
┌─── Tauri Desktop ───┐    ┌─── codeg-server ───┐
│  Tauri 2 Commands    │    │  Axum HTTP + WS    │
│  (window management) │    │  (standalone mode)  │
└──────────┬───────────┘    └──────────┬──────────┘
           └──────────┬───────────────┘
                      v
            Shared Rust Core
              |- AppState
              |- ACP Manager
              |- Parsers (conversation ingestion)
              |- Chat Channels
              |- Git / File Tree / Terminal
              |- MCP marketplace + config
              |- Office Tools (officecli) + Automations
              |- SeaORM + SQLite
                      |
              ┌───────┼───────┐
              v       v       v
  Local Filesystem  Git   Chat Channels
    / Git Repos    Repos  (Telegram, Lark, iLink)