Codeg

Créez visuellement de nouveaux projets avec une interface à panneaux divisés : configuration à gauche, aperçu en temps réel à droite.

Fonctionnalités

• Configuration visuelle — sélectionnez le style, le thème de couleur, la bibliothèque d'icônes, la police, le rayon de bordure et plus dans les menus déroulants ; l'aperçu se met à jour instantanément
• Aperçu en direct — visualisez le rendu de votre configuration en temps réel avant de créer quoi que ce soit
• Création en un clic — cliquez sur « Créer un projet » et le launcher exécute shadcn init avec votre preset, le template de framework (Next.js / Vite / React Router / Astro / Laravel) et le gestionnaire de paquets (pnpm / npm / yarn / bun)
• Détection des gestionnaires de paquets — vérifie automatiquement quels gestionnaires sont installés et affiche leurs versions
• Intégration transparente — le projet nouvellement créé s'ouvre directement dans l'espace de travail Codeg

Prend actuellement en charge le scaffolding de projets shadcn/ui, avec un design à onglets prêt pour d'autres types de projets à l'avenir.

Connectez vos applications de messagerie préférées — Telegram, Lark (Feishu), iLink (Weixin) et plus — à vos agents de codage IA. Créez des tâches, envoyez des messages de suivi, approuvez les permissions, reprenez des sessions et surveillez l'activité directement depuis votre chat — recevez les réponses des agents en temps réel avec les détails des appels d'outils, les demandes de permissions et les résumés de complétion, le tout sans ouvrir de navigateur.

Les supergroupes forum Telegram peuvent aussi utiliser le Telegram topic mode pour lier chaque topic à une session Codeg distincte.

Canaux pris en charge

D'autres canaux (Discord, Slack, DingTalk, etc.) sont prévus pour de futures versions.

Travaillez avec des fichiers Word, Excel et PowerPoint comme flux de travail de premier plan. L'outillage officecli intégré permet à vos agents de créer, analyser, relire et modifier des documents .docx, .xlsx et .pptx — et de prévisualiser le résultat directement dans Codeg.

Fonctionnalités

• Créer et modifier — générez de nouveaux documents ou modifiez des .docx / .xlsx / .pptx existants, y compris graphiques, tableaux et mise en forme
• Analyser et relire — inspectez la structure du document, détectez les problèmes de mise en forme et relisez le contenu
• Aperçu en direct — ouvrez un .docx / .xlsx / .pptx dans un onglet de fichier et il s'affiche en ligne, se mettant à jour automatiquement à chaque modification de l'agent — alimenté par un serveur officecli watch persistant (avec proxy inverse et authentification par capacité pour les environnements web et serveur)
• Actions rapides — la page d'accueil propose des onglets Codage, Office et Recherche scientifique qui insèrent en un clic l'invocation de compétence correspondante et un modèle de prompt dans le compositeur ; les compétences non activées affichent un badge de verrouillage et renvoient vers l'activation
• Paramètres Office Tools — une page de paramètres dédiée installe officecli et gère ses compétences documentaires via une matrice compétence×agent : basculez n'importe quelle paire (compétence, agent) et appliquez des modifications en bloc

Transformez n'importe quel agent en assistant de recherche rigoureux. Codeg intègre un ensemble sélectionné de compétences de recherche scientifique sous licence MIT — de l'idéation à l'analyse jusqu'à la rédaction — qui s'installent dans le magasin central de compétences partagé et se lient aux agents de votre choix, exactement comme les outillages expert et office.

Fonctionnalités

• Compétences sélectionnées — génération d'hypothèses, conception expérimentale, puissance statistique, analyse statistique, analyse exploratoire des données, visualisation scientifique, évaluation critique, évaluation par les pairs, gestion des citations, évaluation des chercheurs, recherche d'articles et schémas IA
• Actions rapides — l'onglet Recherche scientifique de la page d'accueil insère en un clic l'invocation de compétence correspondante ainsi qu'un modèle de prompt localisé dans le compositeur
• Paramètres scientifiques — une page de paramètres dédiée gère les compétences via une matrice compétence×agent, avec des badges signalant les compétences nécessitant une clé API ou un environnement Python

Transformez n'importe quelle configuration du compositeur — agent, modèle, prompt, répertoire de travail et options — en une Automatisation réutilisable s'exécutant sans ouvrir l'interface.

Fonctionnalités

• Configurer une fois, réutiliser à volonté — enregistrez une configuration complète du compositeur comme automatisation nommée
• Planifiée ou à la demande — exécutez-la selon un calendrier cron ou déclenchez-la manuellement
• Exécution sans interface — les automatisations s'exécutent en arrière-plan et créent de vraies sessions que vous pouvez ouvrir dans le workspace à tout moment ; après le démarrage, l'interface revient automatiquement au workspace

Prérequis

• Node.js >=22 (recommandé)
• pnpm >=10
• Rust stable (2021 edition)
• Dépendances de build Tauri 2 (mode bureau uniquement)

Exemple Linux (Debian/Ubuntu) :

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

Binaires

Codeg fournit trois binaires Rust issus d'un seul workspace :

codeg-mcp doit se trouver à côté de son binaire parent au moment de l'exécution — les installeurs, l'image Docker et le bundler de sidecar Tauri le placent tous à côté de codeg / codeg-server. Les builds depuis les sources et les agencements personnalisés peuvent surcharger la recherche via la variable d'environnement CODEG_MCP_BIN=/chemin/abs/codeg-mcp. Si le compagnon est absent, la délégation est ignorée (un seul avertissement est journalisé) et le reste de la session de l'agent continue de fonctionner.

Développement

pnpm install

# Frontend uniquement (serveur de dev Next.js, sans Rust)
pnpm dev

# Export statique du frontend vers out/
pnpm build

# Application de bureau complète (Tauri + Next.js, compile automatiquement le sidecar codeg-mcp)
pnpm tauri dev

# Build de release de l'application de bureau (intègre codeg-mcp comme externalBin)
pnpm tauri build

# Serveur autonome (sans Tauri/GUI requis)
pnpm server:dev
pnpm server:build                  # binaire de release dans src-tauri/target/release/codeg-server

# Compiler explicitement le compagnon codeg-mcp (pour la triplet hôte)
pnpm tauri:prepare-sidecars        # sortie : src-tauri/binaries/codeg-mcp-<triple>

# Sauter la préparation du sidecar lors d'itérations sur le frontend sans besoin de délégation
CODEG_SKIP_SIDECAR=1 pnpm tauri dev

# Lint
pnpm eslint .

# Tests frontend (vitest)
pnpm test
pnpm test:watch
pnpm test:coverage

# Vérifications Rust (exécuter dans src-tauri/)
cargo check                                                     # bureau (features par défaut)
cargo check --no-default-features --bin codeg-server            # mode serveur
cargo check --no-default-features --bin codeg-mcp               # compagnon MCP
cargo clippy --all-targets --features test-utils -- -D warnings

# Tests Rust
cargo test --features test-utils                                # bureau (avec intégration)
cargo test --no-default-features --bin codeg-server --lib       # mode serveur
cargo insta review                                              # accepter les mises à jour de snapshots de parser

Astuce : lorsque vous avez un build récent de codeg-mcp sous src-tauri/target/release/ et que vous voulez y faire pointer un codeg-server lancé manuellement sans réinstaller, exportez CODEG_MCP_BIN=$(pwd)/src-tauri/target/release/codeg-mcp.

Déploiement du serveur

Codeg peut fonctionner comme un serveur web autonome sans environnement de bureau.

Option 1 : Installation en une ligne (Linux / macOS)

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

Installer une version spécifique ou dans un répertoire personnalisé :

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

Puis exécuter :

codeg-server

Option 2 : Installation en une ligne (Windows PowerShell)

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

Ou installer une version spécifique :

.\install.ps1 -Version v0.5.2

Option 3 : Télécharger depuis GitHub Releases

Les binaires pré-compilés (avec les ressources web incluses) sont disponibles sur la page Releases :

# Exemple : télécharger, extraire et exécuter
tar xzf codeg-server-linux-x64.tar.gz
cd codeg-server-linux-x64
CODEG_STATIC_DIR=./web ./codeg-server

Pour les déploiements sans surveillance, démarrez-le avec --supervise afin qu'une mise à jour sur place échouée soit automatiquement annulée — voir Mises à jour sur place.

Option 4 : Docker

# Avec Docker Compose (recommandé)
docker compose up -d

# Ou exécuter directement avec Docker
docker run -d -p 3080:3080 -v codeg-data:/data ghcr.io/xintaofei/codeg:latest

# Avec token personnalisé et répertoire de projet monté
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

L'image Docker utilise un build multi-stage (Node.js + Rust → runtime Debian allégé) et inclut git et ssh pour les opérations sur les dépôts. Les données sont persistées dans le volume /data. Vous pouvez optionnellement monter des répertoires de projets pour accéder aux dépôts locaux depuis le conteneur.

Option 5 : Compiler depuis les sources

pnpm install && pnpm build          # compiler le frontend
cd src-tauri
cargo build --release --bin codeg-server --no-default-features
cargo build --release --bin codeg-mcp --no-default-features    # compagnon de délégation
CODEG_STATIC_DIR=../out ./target/release/codeg-server          # codeg-mcp est détecté comme fichier voisin

Si vous conservez les deux binaires dans des répertoires séparés, définissez CODEG_MCP_BIN=/chemin/abs/vers/codeg-mcp pour que le runtime puisse toujours trouver le compagnon ; sans cela, la délégation multi-agents est désactivée silencieusement.

Mises à jour sur place

Le serveur peut se mettre à jour lui-même depuis Paramètres → Mise à jour logicielle : il télécharge la version signée correspondant à sa plateforme, remplace les binaires et les ressources web sur disque, puis redémarre — sans redéploiement manuel. Cette fonctionnalité est réservée à Linux/macOS (désactivée sous Windows). La version précédente est conservée comme sauvegarde, si bien que le même écran propose une action Revenir en arrière pour y retourner.

Exécutez sous le superviseur pour bénéficier du retour arrière automatique. Démarrez le serveur autonome avec --supervise afin qu'un processus fraîchement mis à jour qui ne parvient pas à démarrer dans la fenêtre d'essai soit automatiquement restauré vers la version précédente :

CODEG_STATIC_DIR=./web ./codeg-server --supervise

Sans --supervise, le serveur se met tout de même à jour sur place (il se ré-exécute lui-même), mais la mise à jour est effectuée au mieux : aucun superviseur n'est présent pour restaurer automatiquement une version incapable de démarrer. L'image Docker s'exécute déjà sous le superviseur.

Les mises à jour Docker modifient le conteneur, pas l'image. Une mise à jour sur place réécrit les binaires et les ressources web à l'intérieur de la couche inscriptible du conteneur en cours d'exécution ; ils n'existent donc que dans ce conteneur. Le volume /data persiste, mais les fichiers mis à jour non : recréer le conteneur — docker compose up --force-recreate, un nouveau docker run, ou une recréation après un docker pull — repart de l'image et abandonne la mise à jour sur place. (Un docker pull seul ne fait que rafraîchir l'image locale ; rien n'est restauré tant que le conteneur n'est pas recréé.) Pour rendre une mise à jour permanente, construisez ou téléchargez une image à la nouvelle version et recréez-en le conteneur.

Configuration

Variables d'environnement :

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)