更新Readme文件
This commit is contained in:
xintaofei
@@ -20,7 +20,7 @@
|
||||
|
||||
Codeg (Code Generation) is an enterprise-grade multi-agent coding workspace.
|
||||
It unifies local AI coding agents (Claude Code, Codex CLI, OpenCode, Gemini CLI,
|
||||
etc.) in one desktop app with session aggregation, parallel `git worktree`
|
||||
OpenClaw, etc.) in one desktop app with session aggregation, parallel `git worktree`
|
||||
development, MCP/Skills management, and integrated Git/file/terminal workflows.
|
||||
|
||||
## Main Interface
|
||||
@@ -52,6 +52,7 @@ development, MCP/Skills management, and integrated Git/file/terminal workflows.
|
||||
| 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` |
|
||||
|
||||
> Note: environment variables take precedence over fallback paths.
|
||||
|
||||
|
||||
@@ -2,6 +2,8 @@
|
||||
|
||||
[](https://github.com/xintaofei/codeg/releases)
|
||||
[](../../LICENSE)
|
||||
[](https://tauri.app/)
|
||||
[](https://nextjs.org/)
|
||||
|
||||
<p>
|
||||
<a href="../../README.md">English</a> |
|
||||
@@ -16,57 +18,139 @@
|
||||
<strong>العربية</strong>
|
||||
</p>
|
||||
|
||||
Codeg (Code Generation) هو مساحة عمل مؤسسية لتوليد الشفرة باستخدام عدة
|
||||
وكلاء Agent.
|
||||
يوحّد الوكلاء المحليين مثل Claude Code وCodex CLI وOpenCode وGemini CLI داخل
|
||||
تطبيق سطح مكتب واحد، مع تجميع الجلسات، وتطوير متوازي عبر `git worktree`،
|
||||
وإدارة MCP/Skills، وسير عمل متكامل لـ Git/الملفات/الطرفية.
|
||||
Codeg (Code Generation) هو مساحة عمل مؤسسية متعددة الوكلاء للبرمجة.
|
||||
يوحّد وكلاء البرمجة المحليين بالذكاء الاصطناعي (Claude Code، Codex CLI، OpenCode، Gemini CLI،
|
||||
OpenClaw، وغيرها) في تطبيق سطح مكتب واحد مع تجميع الجلسات، والتطوير المتوازي
|
||||
عبر `git worktree`، وإدارة MCP/Skills، وسير عمل متكامل لـ Git/الملفات/الطرفية.
|
||||
|
||||
## الواجهة الرئيسية
|
||||
|
||||
|
||||
|
||||
|
||||
## عرض الجلسات كبلاطات
|
||||
|
||||
|
||||
|
||||
|
||||
> الإصدار الحالي: `v0.1.x` (تطوير سريع)
|
||||
> الحالة الحالية: `v0.1.x` (تكرار سريع، مناسب للمتبنين الأوائل)
|
||||
|
||||
## أبرز المزايا
|
||||
|
||||
- مساحة عمل موحّدة لعدة Agent
|
||||
- تجميع محلي للجلسات مع عرض منظّم
|
||||
- تطوير متوازي باستخدام `git worktree`
|
||||
- إدارة MCP (فحص محلي + بحث/تثبيت)
|
||||
- إدارة Skills (عام وعلى مستوى المشروع)
|
||||
- مساحة عمل موحّدة متعددة الوكلاء في نفس المشروع
|
||||
- استيعاب محلي للجلسات مع عرض منظّم
|
||||
- تطوير متوازي مع تدفقات `git worktree` مدمجة
|
||||
- إدارة MCP (فحص محلي + بحث/تثبيت من السجل)
|
||||
- إدارة Skills (نطاق عام ونطاق المشروع)
|
||||
- حلقة هندسية متكاملة (شجرة الملفات، الفروقات، تغييرات git، الإيداع، الطرفية)
|
||||
|
||||
## النطاق المدعوم
|
||||
|
||||
### 1) استيعاب الجلسات (الجلسات التاريخية)
|
||||
|
||||
| الوكيل | مسار متغير البيئة | الافتراضي في macOS / Linux | الافتراضي في Windows |
|
||||
| --- | --- | --- | --- |
|
||||
| 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` |
|
||||
|
||||
> ملاحظة: متغيرات البيئة لها الأولوية على المسارات الافتراضية.
|
||||
|
||||
### 2) جلسات ACP في الوقت الفعلي
|
||||
|
||||
يتضمن السجل المدمج أكثر من 20 محولًا، مثل Claude Code وCodex CLI
|
||||
وGemini CLI وOpenCode وOpenClaw وGitHub Copilot وCline وQwen Code وغيرها.
|
||||
|
||||
### 3) دعم إعدادات Skills
|
||||
|
||||
- مدعوم: `Claude Code / Codex / OpenCode / Gemini CLI / OpenClaw`
|
||||
- سيتم إضافة المزيد من المحولات تدريجيًا
|
||||
|
||||
### 4) التطبيقات المستهدفة لـ MCP
|
||||
|
||||
الأهداف القابلة للكتابة حاليًا:
|
||||
|
||||
- Claude Code
|
||||
- Codex
|
||||
- OpenCode
|
||||
|
||||
## البدء السريع
|
||||
|
||||
### المتطلبات
|
||||
|
||||
- Node.js `>=22`
|
||||
- Node.js `>=22` (مُوصى به)
|
||||
- pnpm `>=10`
|
||||
- Rust stable (2021 edition)
|
||||
- تبعيات بناء Tauri 2
|
||||
|
||||
### الأوامر
|
||||
مثال على Linux (Debian/Ubuntu):
|
||||
|
||||
```bash
|
||||
sudo apt-get update
|
||||
sudo apt-get install -y \
|
||||
libwebkit2gtk-4.1-dev \
|
||||
libayatana-appindicator3-dev \
|
||||
librsvg2-dev \
|
||||
patchelf
|
||||
```
|
||||
|
||||
### التطوير
|
||||
|
||||
```bash
|
||||
pnpm install
|
||||
|
||||
# تطبيق سطح المكتب الكامل (Tauri + Next.js)
|
||||
pnpm tauri dev
|
||||
|
||||
# الواجهة الأمامية فقط
|
||||
pnpm dev
|
||||
|
||||
# تصدير ثابت للواجهة الأمامية إلى out/
|
||||
pnpm build
|
||||
|
||||
# بناء تطبيق سطح المكتب
|
||||
pnpm tauri build
|
||||
|
||||
# فحص الأكواد
|
||||
pnpm eslint .
|
||||
|
||||
# شغّل داخل src-tauri/
|
||||
# فحوصات Rust (تنفيذ في src-tauri/)
|
||||
cargo check
|
||||
cargo clippy
|
||||
cargo build
|
||||
```
|
||||
|
||||
## الهندسة المعمارية
|
||||
|
||||
```text
|
||||
Next.js 16 (Static Export) + React 19
|
||||
|
|
||||
| invoke()
|
||||
v
|
||||
Tauri 2 Commands (Rust)
|
||||
|- ACP Manager
|
||||
|- Parsers (local session ingestion)
|
||||
|- Git / File Tree / Terminal runtime
|
||||
|- MCP marketplace + local config writer
|
||||
|- SeaORM + SQLite
|
||||
|
|
||||
v
|
||||
Local Filesystem / Local Agent Data / Git Repos
|
||||
```
|
||||
|
||||
## القيود
|
||||
|
||||
- الواجهة الأمامية تستخدم التصدير الثابت (`output: "export"`)
|
||||
- لا توجد مسارات ديناميكية في Next.js (`[param]`)؛ استخدم معاملات الاستعلام بدلاً من ذلك
|
||||
- معاملات أوامر Tauri: `camelCase` في الواجهة الأمامية، `snake_case` في Rust
|
||||
- TypeScript في الوضع الصارم
|
||||
|
||||
## الخصوصية والأمان
|
||||
|
||||
- محلي أولاً بشكل افتراضي للتحليل والتخزين وعمليات المشروع
|
||||
- الوصول إلى الشبكة يحدث فقط عند الإجراءات التي يبدأها المستخدم
|
||||
- دعم بروكسي النظام لبيئات المؤسسات
|
||||
|
||||
## الترخيص
|
||||
|
||||
Apache-2.0. راجع `LICENSE`.
|
||||
|
||||
@@ -2,6 +2,8 @@
|
||||
|
||||
[](https://github.com/xintaofei/codeg/releases)
|
||||
[](../../LICENSE)
|
||||
[](https://tauri.app/)
|
||||
[](https://nextjs.org/)
|
||||
|
||||
<p>
|
||||
<a href="../../README.md">English</a> |
|
||||
@@ -16,58 +18,141 @@
|
||||
<a href="./README.ar.md">العربية</a>
|
||||
</p>
|
||||
|
||||
Codeg (Code Generation) ist ein Enterprise-Workspace für Code-Generierung mit
|
||||
mehreren Agenten.
|
||||
Lokale KI-Coding-Agenten wie Claude Code, Codex CLI, OpenCode und Gemini CLI
|
||||
werden in einer Desktop-App zusammengeführt: mit Sitzungsaggregation,
|
||||
paralleler `git worktree`-Entwicklung, MCP/Skills-Verwaltung und integriertem
|
||||
Git/Datei/Terminal-Workflow.
|
||||
Codeg (Code Generation) ist ein unternehmenstauglicher Multi-Agent-Workspace
|
||||
für die Programmierung.
|
||||
Es vereint lokale KI-Coding-Agenten (Claude Code, Codex CLI, OpenCode,
|
||||
Gemini CLI, OpenClaw usw.) in einer Desktop-App mit Sitzungsaggregation,
|
||||
paralleler `git worktree`-Entwicklung, MCP/Skills-Verwaltung und integrierten
|
||||
Git/Datei/Terminal-Workflows.
|
||||
|
||||
## Hauptoberfläche
|
||||
|
||||
|
||||
|
||||
|
||||
## Sitzungskachelansicht
|
||||
|
||||
|
||||
|
||||
|
||||
> Aktuelle Version: `v0.1.x` (schnelle Iteration)
|
||||
> Aktueller Status: `v0.1.x` (schnelle Iteration, geeignet für Early Adopters)
|
||||
|
||||
## Highlights
|
||||
|
||||
- Einheitlicher Multi-Agent-Workspace
|
||||
- Lokale Sitzungsaggregation mit strukturierter Darstellung
|
||||
- Parallele Entwicklung mit `git worktree`
|
||||
- MCP-Verwaltung (lokaler Scan + Suche/Installation)
|
||||
- Einheitlicher Multi-Agent-Workspace im selben Projekt
|
||||
- Lokale Sitzungserfassung mit strukturierter Darstellung
|
||||
- Parallele Entwicklung mit integrierten `git worktree`-Abläufen
|
||||
- MCP-Verwaltung (lokaler Scan + Registry-Suche/Installation)
|
||||
- Skills-Verwaltung (global und projektbezogen)
|
||||
- Integrierter Engineering-Kreislauf (Dateibaum, Diff, Git-Änderungen, Commit, Terminal)
|
||||
|
||||
## Unterstützter Umfang
|
||||
|
||||
### 1) Sitzungserfassung (historische Sitzungen)
|
||||
|
||||
| Agent | Umgebungsvariablen-Pfad | macOS / Linux Standard | Windows Standard |
|
||||
| --- | --- | --- | --- |
|
||||
| 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` |
|
||||
|
||||
> Hinweis: Umgebungsvariablen haben Vorrang vor Fallback-Pfaden.
|
||||
|
||||
### 2) ACP-Echtzeitsitzungen
|
||||
|
||||
Das integrierte Registry enthält über 20 Adapter, darunter Claude Code, Codex CLI,
|
||||
Gemini CLI, OpenCode, OpenClaw, GitHub Copilot, Cline, Qwen Code und weitere.
|
||||
|
||||
### 3) Skills-Einstellungen
|
||||
|
||||
- Unterstützt: `Claude Code / Codex / OpenCode / Gemini CLI / OpenClaw`
|
||||
- Weitere Adapter werden schrittweise hinzugefügt
|
||||
|
||||
### 4) MCP-Zielanwendungen
|
||||
|
||||
Aktuelle beschreibbare Ziele:
|
||||
|
||||
- Claude Code
|
||||
- Codex
|
||||
- OpenCode
|
||||
|
||||
## Schnellstart
|
||||
|
||||
### Voraussetzungen
|
||||
|
||||
- Node.js `>=22`
|
||||
- Node.js `>=22` (empfohlen)
|
||||
- pnpm `>=10`
|
||||
- Rust stable (2021 edition)
|
||||
- Tauri-2-Build-Abhängigkeiten
|
||||
|
||||
### Befehle
|
||||
Linux-Beispiel (Debian/Ubuntu):
|
||||
|
||||
```bash
|
||||
sudo apt-get update
|
||||
sudo apt-get install -y \
|
||||
libwebkit2gtk-4.1-dev \
|
||||
libayatana-appindicator3-dev \
|
||||
librsvg2-dev \
|
||||
patchelf
|
||||
```
|
||||
|
||||
### Entwicklung
|
||||
|
||||
```bash
|
||||
pnpm install
|
||||
|
||||
# Vollständige Desktop-App (Tauri + Next.js)
|
||||
pnpm tauri dev
|
||||
|
||||
# Nur Frontend
|
||||
pnpm dev
|
||||
|
||||
# Frontend-Statikexport nach out/
|
||||
pnpm build
|
||||
|
||||
# Desktop-Build
|
||||
pnpm tauri build
|
||||
|
||||
# Lint
|
||||
pnpm eslint .
|
||||
|
||||
# In src-tauri/ ausführen
|
||||
# Rust-Prüfungen (in src-tauri/ ausführen)
|
||||
cargo check
|
||||
cargo clippy
|
||||
cargo build
|
||||
```
|
||||
|
||||
## Architektur
|
||||
|
||||
```text
|
||||
Next.js 16 (Static Export) + React 19
|
||||
|
|
||||
| invoke()
|
||||
v
|
||||
Tauri 2 Commands (Rust)
|
||||
|- ACP Manager
|
||||
|- Parsers (local session ingestion)
|
||||
|- Git / File Tree / Terminal runtime
|
||||
|- MCP marketplace + local config writer
|
||||
|- SeaORM + SQLite
|
||||
|
|
||||
v
|
||||
Local Filesystem / Local Agent Data / Git Repos
|
||||
```
|
||||
|
||||
## Einschränkungen
|
||||
|
||||
- Frontend verwendet statischen Export (`output: "export"`)
|
||||
- Keine dynamischen Next.js-Routen (`[param]`); stattdessen Query-Parameter verwenden
|
||||
- Tauri-Befehlsparameter: `camelCase` im Frontend, `snake_case` in Rust
|
||||
- TypeScript im strikten Modus
|
||||
|
||||
## Datenschutz und Sicherheit
|
||||
|
||||
- Standardmäßig lokal für Analyse, Speicherung und Projektoperationen
|
||||
- Netzwerkzugriff erfolgt nur bei benutzergesteuerten Aktionen
|
||||
- Systemproxy-Unterstützung für Unternehmensumgebungen
|
||||
|
||||
## Lizenz
|
||||
|
||||
Apache-2.0. Siehe `LICENSE`.
|
||||
|
||||
@@ -2,6 +2,8 @@
|
||||
|
||||
[](https://github.com/xintaofei/codeg/releases)
|
||||
[](../../LICENSE)
|
||||
[](https://tauri.app/)
|
||||
[](https://nextjs.org/)
|
||||
|
||||
<p>
|
||||
<a href="../../README.md">English</a> |
|
||||
@@ -16,58 +18,141 @@
|
||||
<a href="./README.ar.md">العربية</a>
|
||||
</p>
|
||||
|
||||
Codeg (Code Generation) es un espacio de trabajo empresarial para generación de
|
||||
código con múltiples Agent.
|
||||
Integra agentes locales como Claude Code, Codex CLI, OpenCode y Gemini CLI en
|
||||
una sola aplicación de escritorio, con agregación de sesiones, desarrollo
|
||||
paralelo con `git worktree`, gestión de MCP/Skills y flujo integrado de
|
||||
Git/archivos/terminal.
|
||||
Codeg (Code Generation) es un espacio de trabajo empresarial para codificación
|
||||
con múltiples agentes.
|
||||
Integra agentes locales de codificación con IA (Claude Code, Codex CLI, OpenCode,
|
||||
Gemini CLI, OpenClaw, etc.) en una sola aplicación de escritorio, con agregación
|
||||
de sesiones, desarrollo paralelo con `git worktree`, gestión de MCP/Skills y
|
||||
flujos integrados de Git/archivos/terminal.
|
||||
|
||||
## Interfaz principal
|
||||
|
||||
|
||||
|
||||
|
||||
## Vista de mosaico de sesiones
|
||||
|
||||
|
||||
|
||||
|
||||
> Versión actual: `v0.1.x` (iteración rápida)
|
||||
> Estado actual: `v0.1.x` (iteración rápida, adecuado para early adopters)
|
||||
|
||||
## Puntos clave
|
||||
## Puntos destacados
|
||||
|
||||
- Espacio de trabajo unificado para múltiples Agent
|
||||
- Agregación local de sesiones con vista estructurada
|
||||
- Desarrollo paralelo con `git worktree`
|
||||
- Gestión MCP (escaneo local + búsqueda/instalación)
|
||||
- Gestión de Skills (global y por proyecto)
|
||||
- Espacio de trabajo unificado para múltiples agentes en el mismo proyecto
|
||||
- Ingesta local de sesiones con renderizado estructurado
|
||||
- Desarrollo paralelo con flujos integrados de `git worktree`
|
||||
- Gestión de MCP (escaneo local + búsqueda/instalación desde registro)
|
||||
- Gestión de Skills (ámbito global y por proyecto)
|
||||
- Ciclo de ingeniería integrado (árbol de archivos, diff, cambios git, commit, terminal)
|
||||
|
||||
## Alcance soportado
|
||||
|
||||
### 1) Ingesta de sesiones (sesiones históricas)
|
||||
|
||||
| Agente | Ruta de variable de entorno | Ruta por defecto en macOS / Linux | Ruta por defecto en Windows |
|
||||
| --- | --- | --- | --- |
|
||||
| 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` |
|
||||
|
||||
> Nota: las variables de entorno tienen prioridad sobre las rutas de respaldo.
|
||||
|
||||
### 2) Sesiones en tiempo real con ACP
|
||||
|
||||
El registro integrado incluye más de 20 adaptadores, como Claude Code, Codex CLI,
|
||||
Gemini CLI, OpenCode, OpenClaw, GitHub Copilot, Cline, Qwen Code, entre otros.
|
||||
|
||||
### 3) Configuración de Skills
|
||||
|
||||
- Soportados: `Claude Code / Codex / OpenCode / Gemini CLI / OpenClaw`
|
||||
- Se añadirán más adaptadores progresivamente
|
||||
|
||||
### 4) Aplicaciones destino de MCP
|
||||
|
||||
Destinos de escritura actuales:
|
||||
|
||||
- Claude Code
|
||||
- Codex
|
||||
- OpenCode
|
||||
|
||||
## Inicio rápido
|
||||
|
||||
### Requisitos
|
||||
|
||||
- Node.js `>=22`
|
||||
- Node.js `>=22` (recomendado)
|
||||
- pnpm `>=10`
|
||||
- Rust stable (2021 edition)
|
||||
- Dependencias de build para Tauri 2
|
||||
- Dependencias de compilación de Tauri 2
|
||||
|
||||
### Comandos
|
||||
Ejemplo para Linux (Debian/Ubuntu):
|
||||
|
||||
```bash
|
||||
sudo apt-get update
|
||||
sudo apt-get install -y \
|
||||
libwebkit2gtk-4.1-dev \
|
||||
libayatana-appindicator3-dev \
|
||||
librsvg2-dev \
|
||||
patchelf
|
||||
```
|
||||
|
||||
### Desarrollo
|
||||
|
||||
```bash
|
||||
pnpm install
|
||||
|
||||
# Aplicación de escritorio completa (Tauri + Next.js)
|
||||
pnpm tauri dev
|
||||
|
||||
# Solo frontend
|
||||
pnpm dev
|
||||
|
||||
# Exportación estática del frontend a out/
|
||||
pnpm build
|
||||
|
||||
# Compilación de escritorio
|
||||
pnpm tauri build
|
||||
|
||||
# Lint
|
||||
pnpm eslint .
|
||||
|
||||
# Ejecutar en src-tauri/
|
||||
# Verificaciones de Rust (ejecutar en src-tauri/)
|
||||
cargo check
|
||||
cargo clippy
|
||||
cargo build
|
||||
```
|
||||
|
||||
## Arquitectura
|
||||
|
||||
```text
|
||||
Next.js 16 (Static Export) + React 19
|
||||
|
|
||||
| invoke()
|
||||
v
|
||||
Tauri 2 Commands (Rust)
|
||||
|- ACP Manager
|
||||
|- Parsers (local session ingestion)
|
||||
|- Git / File Tree / Terminal runtime
|
||||
|- MCP marketplace + local config writer
|
||||
|- SeaORM + SQLite
|
||||
|
|
||||
v
|
||||
Local Filesystem / Local Agent Data / Git Repos
|
||||
```
|
||||
|
||||
## Restricciones
|
||||
|
||||
- El frontend usa exportación estática (`output: "export"`)
|
||||
- Sin rutas dinámicas de Next.js (`[param]`); se usan parámetros de consulta en su lugar
|
||||
- Parámetros de comandos Tauri: `camelCase` en frontend, `snake_case` en Rust
|
||||
- TypeScript en modo estricto
|
||||
|
||||
## Privacidad y seguridad
|
||||
|
||||
- Enfoque local por defecto para análisis, almacenamiento y operaciones de proyecto
|
||||
- El acceso a la red solo ocurre mediante acciones iniciadas por el usuario
|
||||
- Soporte de proxy del sistema para entornos empresariales
|
||||
|
||||
## Licencia
|
||||
|
||||
Apache-2.0. Ver `LICENSE`.
|
||||
|
||||
@@ -2,6 +2,8 @@
|
||||
|
||||
[](https://github.com/xintaofei/codeg/releases)
|
||||
[](../../LICENSE)
|
||||
[](https://tauri.app/)
|
||||
[](https://nextjs.org/)
|
||||
|
||||
<p>
|
||||
<a href="../../README.md">English</a> |
|
||||
@@ -16,58 +18,139 @@
|
||||
<a href="./README.ar.md">العربية</a>
|
||||
</p>
|
||||
|
||||
Codeg (Code Generation) est un workspace de génération de code multi-Agent de
|
||||
niveau entreprise.
|
||||
Il unifie des agents locaux comme Claude Code, Codex CLI, OpenCode et Gemini
|
||||
CLI dans une application desktop avec agrégation des sessions, développement
|
||||
parallèle via `git worktree`, gestion MCP/Skills et workflow intégré
|
||||
Git/fichiers/terminal.
|
||||
Codeg (Code Generation) est un workspace de codage multi-agents de niveau entreprise.
|
||||
Il unifie les agents de codage IA locaux (Claude Code, Codex CLI, OpenCode, Gemini CLI,
|
||||
OpenClaw, etc.) dans une seule application de bureau avec agrégation de sessions, développement
|
||||
parallèle via `git worktree`, gestion MCP/Skills et workflows intégrés Git/fichiers/terminal.
|
||||
|
||||
## Interface principale
|
||||
|
||||
|
||||
|
||||
|
||||
## Affichage en tuiles des sessions
|
||||
|
||||
|
||||
|
||||
|
||||
> Version actuelle : `v0.1.x` (itération rapide)
|
||||
> Statut actuel : `v0.1.x` (itération rapide, adapté aux utilisateurs précoces)
|
||||
|
||||
## Points forts
|
||||
|
||||
- Workspace unifié pour plusieurs Agent
|
||||
- Agrégation locale des sessions avec affichage structuré
|
||||
- Développement parallèle avec `git worktree`
|
||||
- Gestion MCP (scan local + recherche/installation)
|
||||
- Gestion des Skills (global et projet)
|
||||
- Workspace multi-agents unifié dans le même projet
|
||||
- Ingestion locale des sessions avec rendu structuré
|
||||
- Développement parallèle avec flux `git worktree` intégré
|
||||
- Gestion MCP (scan local + recherche/installation depuis le registre)
|
||||
- Gestion des Skills (portée globale et projet)
|
||||
- Boucle d'ingénierie intégrée (arborescence de fichiers, diff, changements git, commit, terminal)
|
||||
|
||||
## Périmètre pris en charge
|
||||
|
||||
### 1) Ingestion de sessions (sessions historiques)
|
||||
|
||||
| Agent | Chemin via variable d'environnement | Défaut macOS / Linux | Défaut Windows |
|
||||
| --- | --- | --- | --- |
|
||||
| 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` |
|
||||
|
||||
> Remarque : les variables d'environnement ont priorité sur les chemins par défaut.
|
||||
|
||||
### 2) Sessions temps réel ACP
|
||||
|
||||
Le registre intégré comprend plus de 20 adaptateurs, tels que Claude Code, Codex CLI,
|
||||
Gemini CLI, OpenCode, OpenClaw, GitHub Copilot, Cline, Qwen Code, et d'autres.
|
||||
|
||||
### 3) Prise en charge des paramètres Skills
|
||||
|
||||
- Pris en charge : `Claude Code / Codex / OpenCode / Gemini CLI / OpenClaw`
|
||||
- D'autres adaptateurs seront ajoutés progressivement
|
||||
|
||||
### 4) Applications cibles MCP
|
||||
|
||||
Cibles en écriture actuelles :
|
||||
|
||||
- Claude Code
|
||||
- Codex
|
||||
- OpenCode
|
||||
|
||||
## Démarrage rapide
|
||||
|
||||
### Prérequis
|
||||
|
||||
- Node.js `>=22`
|
||||
- Node.js `>=22` (recommandé)
|
||||
- pnpm `>=10`
|
||||
- Rust stable (2021 edition)
|
||||
- Dépendances de build Tauri 2
|
||||
|
||||
### Commandes
|
||||
Exemple Linux (Debian/Ubuntu) :
|
||||
|
||||
```bash
|
||||
sudo apt-get update
|
||||
sudo apt-get install -y \
|
||||
libwebkit2gtk-4.1-dev \
|
||||
libayatana-appindicator3-dev \
|
||||
librsvg2-dev \
|
||||
patchelf
|
||||
```
|
||||
|
||||
### Développement
|
||||
|
||||
```bash
|
||||
pnpm install
|
||||
|
||||
# Application de bureau complète (Tauri + Next.js)
|
||||
pnpm tauri dev
|
||||
|
||||
# Frontend uniquement
|
||||
pnpm dev
|
||||
|
||||
# Export statique du frontend vers out/
|
||||
pnpm build
|
||||
|
||||
# Build de l'application de bureau
|
||||
pnpm tauri build
|
||||
|
||||
# Lint
|
||||
pnpm eslint .
|
||||
|
||||
# Exécuter dans src-tauri/
|
||||
# Vérifications Rust (exécuter dans src-tauri/)
|
||||
cargo check
|
||||
cargo clippy
|
||||
cargo build
|
||||
```
|
||||
|
||||
## Architecture
|
||||
|
||||
```text
|
||||
Next.js 16 (Static Export) + React 19
|
||||
|
|
||||
| invoke()
|
||||
v
|
||||
Tauri 2 Commands (Rust)
|
||||
|- ACP Manager
|
||||
|- Parsers (local session ingestion)
|
||||
|- Git / File Tree / Terminal runtime
|
||||
|- MCP marketplace + local config writer
|
||||
|- SeaORM + SQLite
|
||||
|
|
||||
v
|
||||
Local Filesystem / Local Agent Data / Git Repos
|
||||
```
|
||||
|
||||
## Contraintes
|
||||
|
||||
- Le frontend utilise l'export statique (`output: "export"`)
|
||||
- Pas de routes dynamiques Next.js (`[param]`) ; utiliser les paramètres de requête à la place
|
||||
- Paramètres des commandes Tauri : `camelCase` côté frontend, `snake_case` côté Rust
|
||||
- TypeScript en mode strict
|
||||
|
||||
## Confidentialité et sécurité
|
||||
|
||||
- Local-first par défaut pour l'analyse, le stockage et les opérations sur le projet
|
||||
- L'accès réseau ne se produit que lors d'actions déclenchées par l'utilisateur
|
||||
- Prise en charge du proxy système pour les environnements d'entreprise
|
||||
|
||||
## Licence
|
||||
|
||||
Apache-2.0. Voir `LICENSE`.
|
||||
|
||||
@@ -2,6 +2,8 @@
|
||||
|
||||
[](https://github.com/xintaofei/codeg/releases)
|
||||
[](../../LICENSE)
|
||||
[](https://tauri.app/)
|
||||
[](https://nextjs.org/)
|
||||
|
||||
<p>
|
||||
<a href="../../README.md">English</a> |
|
||||
@@ -16,75 +18,138 @@
|
||||
<a href="./README.ar.md">العربية</a>
|
||||
</p>
|
||||
|
||||
Codeg（Code Generation）は、複数 Agent 向けのエンタープライズ級コード生成ワークスペースです。
|
||||
Claude Code、Codex CLI、OpenCode、Gemini CLI などのローカル AI コーディング Agent を 1 つのデスクトップアプリに統合し、セッション集約、並列 `git worktree` 開発、MCP/Skills 管理、Git/ファイル/ターミナル連携を提供します。
|
||||
Codeg（Code Generation）は、エンタープライズ級のマルチ Agent コーディングワークスペースです。
|
||||
Claude Code、Codex CLI、OpenCode、Gemini CLI、OpenClaw などのローカル AI コーディング Agent を
|
||||
1 つのデスクトップアプリに統合し、セッション集約、並列 `git worktree` 開発、MCP/Skills 管理、
|
||||
Git/ファイル/ターミナル連携ワークフローを提供します。
|
||||
|
||||
## メインインターフェース
|
||||
|
||||
|
||||
|
||||
|
||||
## セッションタイル表示
|
||||
|
||||
|
||||
|
||||
|
||||
> 現在のバージョン: `v0.1.x`（高速に改善中）
|
||||
> 現在のステータス: `v0.1.x`（高速イテレーション中、アーリーアダプター向け）
|
||||
|
||||
## 主な特長
|
||||
## ハイライト
|
||||
|
||||
- 同一プロジェクトでのマルチ Agent 統合ワークスペース
|
||||
- ローカルセッションの集約と構造化表示
|
||||
- `git worktree` による並列開発
|
||||
- MCP 管理（ローカルスキャン + 検索/インストール）
|
||||
- Skills 管理（グローバル/プロジェクト）
|
||||
- ファイルツリー、Diff、Git、コミット、ターミナルの一体化
|
||||
- ローカルセッションの取り込みと構造化レンダリング
|
||||
- 内蔵 `git worktree` フローによる並列開発
|
||||
- MCP 管理（ローカルスキャン + レジストリ検索/インストール）
|
||||
- Skills 管理（グローバルおよびプロジェクトスコープ）
|
||||
- 統合エンジニアリングループ（ファイルツリー、Diff、Git 変更、コミット、ターミナル）
|
||||
|
||||
## 対応範囲
|
||||
|
||||
### 1) セッション取り込み（履歴）
|
||||
### 1) セッション取り込み（履歴セッション）
|
||||
|
||||
| Agent | 環境変数優先パス | macOS / Linux 既定 | Windows 既定 |
|
||||
| Agent | 環境変数パス | macOS / Linux デフォルト | Windows デフォルト |
|
||||
| --- | --- | --- | --- |
|
||||
| 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` |
|
||||
|
||||
> 注: 環境変数はフォールバックパスより優先されます。
|
||||
|
||||
### 2) ACP リアルタイムセッション
|
||||
|
||||
20 以上の Agent アダプターを内蔵（Claude Code、Codex CLI、Gemini CLI、OpenCode、OpenClaw など）。
|
||||
内蔵レジストリには、Claude Code、Codex CLI、Gemini CLI、OpenCode、OpenClaw、GitHub Copilot、Cline、Qwen Code など 20 以上のアダプターが含まれています。
|
||||
|
||||
### 3) Skills 設定対応
|
||||
### 3) Skills 設定サポート
|
||||
|
||||
- 対応済み: `Claude Code / Codex / OpenCode / Gemini CLI / OpenClaw`
|
||||
- 他 Agent は順次追加予定
|
||||
- 他のアダプターは順次追加予定
|
||||
|
||||
### 4) MCP ターゲットアプリ
|
||||
|
||||
現在の書き込み対象:
|
||||
|
||||
- Claude Code
|
||||
- Codex
|
||||
- OpenCode
|
||||
|
||||
## クイックスタート
|
||||
|
||||
### 要件
|
||||
### 必要条件
|
||||
|
||||
- Node.js `>=22`
|
||||
- Node.js `>=22`（推奨）
|
||||
- pnpm `>=10`
|
||||
- Rust stable（2021 edition）
|
||||
- Tauri 2 のビルド依存
|
||||
- Tauri 2 ビルド依存パッケージ
|
||||
|
||||
### 開発コマンド
|
||||
Linux（Debian/Ubuntu）の例:
|
||||
|
||||
```bash
|
||||
sudo apt-get update
|
||||
sudo apt-get install -y \
|
||||
libwebkit2gtk-4.1-dev \
|
||||
libayatana-appindicator3-dev \
|
||||
librsvg2-dev \
|
||||
patchelf
|
||||
```
|
||||
|
||||
### 開発
|
||||
|
||||
```bash
|
||||
pnpm install
|
||||
|
||||
# デスクトップアプリ全体（Tauri + Next.js）
|
||||
pnpm tauri dev
|
||||
|
||||
# フロントエンドのみ
|
||||
pnpm dev
|
||||
|
||||
# フロントエンド静的エクスポート（out/ へ）
|
||||
pnpm build
|
||||
|
||||
# デスクトップビルド
|
||||
pnpm tauri build
|
||||
|
||||
# Lint
|
||||
pnpm eslint .
|
||||
|
||||
# src-tauri/ で実行
|
||||
# Rust チェック（src-tauri/ で実行）
|
||||
cargo check
|
||||
cargo clippy
|
||||
cargo build
|
||||
```
|
||||
|
||||
## アーキテクチャ
|
||||
|
||||
```text
|
||||
Next.js 16 (Static Export) + React 19
|
||||
|
|
||||
| invoke()
|
||||
v
|
||||
Tauri 2 Commands (Rust)
|
||||
|- ACP Manager
|
||||
|- Parsers (local session ingestion)
|
||||
|- Git / File Tree / Terminal runtime
|
||||
|- MCP marketplace + local config writer
|
||||
|- SeaORM + SQLite
|
||||
|
|
||||
v
|
||||
Local Filesystem / Local Agent Data / Git Repos
|
||||
```
|
||||
|
||||
## 制約事項
|
||||
|
||||
- フロントエンドは静的エクスポートを使用（`output: "export"`）
|
||||
- Next.js の動的ルート（`[param]`）は不可。代わりにクエリパラメータを使用
|
||||
- Tauri コマンドパラメータ: フロントエンドは `camelCase`、Rust は `snake_case`
|
||||
- TypeScript strict モード
|
||||
|
||||
## プライバシーとセキュリティ
|
||||
|
||||
- 解析、ストレージ、プロジェクト操作はデフォルトでローカルファースト
|
||||
- ネットワークアクセスはユーザーが明示的に操作した場合のみ発生
|
||||
- エンタープライズ環境向けのシステムプロキシサポート
|
||||
|
||||
## ライセンス
|
||||
|
||||
Apache-2.0。`LICENSE` を参照してください。
|
||||
|
||||
@@ -2,6 +2,8 @@
|
||||
|
||||
[](https://github.com/xintaofei/codeg/releases)
|
||||
[](../../LICENSE)
|
||||
[](https://tauri.app/)
|
||||
[](https://nextjs.org/)
|
||||
|
||||
<p>
|
||||
<a href="../../README.md">English</a> |
|
||||
@@ -16,66 +18,138 @@
|
||||
<a href="./README.ar.md">العربية</a>
|
||||
</p>
|
||||
|
||||
Codeg(Code Generation)는 멀티 Agent를 위한 엔터프라이즈급 코드 생성 워크스페이스입니다.
|
||||
Claude Code, Codex CLI, OpenCode, Gemini CLI 등 로컬 AI 코딩 Agent를 하나의 데스크톱 앱으로 통합하여 세션 집계, 병렬 `git worktree` 개발, MCP/Skills 관리, Git/파일/터미널 통합 워크플로를 제공합니다.
|
||||
Codeg(Code Generation)는 엔터프라이즈급 멀티 Agent 코딩 워크스페이스입니다.
|
||||
Claude Code, Codex CLI, OpenCode, Gemini CLI, OpenClaw 등 로컬 AI 코딩 Agent를
|
||||
하나의 데스크톱 앱으로 통합하여 세션 집계, 병렬 `git worktree` 개발, MCP/Skills 관리,
|
||||
Git/파일/터미널 통합 워크플로를 제공합니다.
|
||||
|
||||
## 메인 인터페이스
|
||||
|
||||
|
||||
|
||||
|
||||
## 세션 타일 표시
|
||||
|
||||
|
||||
|
||||
|
||||
> 현재 버전: `v0.1.x` (빠르게 개선 중)
|
||||
> 현재 상태: `v0.1.x` (빠른 반복 개발 중, 얼리 어답터에 적합)
|
||||
|
||||
## 핵심 기능
|
||||
## 하이라이트
|
||||
|
||||
- 하나의 프로젝트에서 멀티 Agent 통합 사용
|
||||
- 로컬 세션 집계 및 구조화 표시
|
||||
- 내장 `git worktree` 병렬 개발
|
||||
- MCP 관리(로컬 스캔 + 검색/설치)
|
||||
- Skills 관리(전역/프로젝트)
|
||||
- 파일 트리, Diff, Git, 커밋, 터미널 통합
|
||||
- 동일 프로젝트에서 멀티 Agent 통합 워크스페이스
|
||||
- 로컬 세션 수집 및 구조화 렌더링
|
||||
- 내장 `git worktree` 플로를 통한 병렬 개발
|
||||
- MCP 관리 (로컬 스캔 + 레지스트리 검색/설치)
|
||||
- Skills 관리 (글로벌 및 프로젝트 범위)
|
||||
- 통합 엔지니어링 루프 (파일 트리, Diff, Git 변경사항, 커밋, 터미널)
|
||||
|
||||
## 지원 범위
|
||||
|
||||
### 1) 세션 수집(히스토리)
|
||||
### 1) 세션 수집 (히스토리 세션)
|
||||
|
||||
| Agent | 환경 변수 우선 경로 | macOS / Linux 기본 경로 | Windows 기본 경로 |
|
||||
| Agent | 환경 변수 경로 | macOS / Linux 기본값 | Windows 기본값 |
|
||||
| --- | --- | --- | --- |
|
||||
| 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` |
|
||||
|
||||
> 참고: 환경 변수가 기본 경로보다 우선합니다.
|
||||
|
||||
### 2) ACP 실시간 세션
|
||||
|
||||
내장 레지스트리에는 Claude Code, Codex CLI, Gemini CLI, OpenCode, OpenClaw, GitHub Copilot, Cline, Qwen Code 등 20개 이상의 어댑터가 포함되어 있습니다.
|
||||
|
||||
### 3) Skills 설정 지원
|
||||
|
||||
- 지원: `Claude Code / Codex / OpenCode / Gemini CLI / OpenClaw`
|
||||
- 추가 어댑터는 순차적으로 추가 예정
|
||||
|
||||
### 4) MCP 대상 앱
|
||||
|
||||
현재 쓰기 가능한 대상:
|
||||
|
||||
- Claude Code
|
||||
- Codex
|
||||
- OpenCode
|
||||
|
||||
## 빠른 시작
|
||||
|
||||
### 요구 사항
|
||||
|
||||
- Node.js `>=22`
|
||||
- Node.js `>=22` (권장)
|
||||
- pnpm `>=10`
|
||||
- Rust stable (2021 edition)
|
||||
- Tauri 2 빌드 의존성
|
||||
|
||||
### 개발 명령
|
||||
Linux (Debian/Ubuntu) 예시:
|
||||
|
||||
```bash
|
||||
sudo apt-get update
|
||||
sudo apt-get install -y \
|
||||
libwebkit2gtk-4.1-dev \
|
||||
libayatana-appindicator3-dev \
|
||||
librsvg2-dev \
|
||||
patchelf
|
||||
```
|
||||
|
||||
### 개발
|
||||
|
||||
```bash
|
||||
pnpm install
|
||||
|
||||
# 전체 데스크톱 앱 (Tauri + Next.js)
|
||||
pnpm tauri dev
|
||||
|
||||
# 프론트엔드만
|
||||
pnpm dev
|
||||
|
||||
# 프론트엔드 정적 내보내기 (out/)
|
||||
pnpm build
|
||||
|
||||
# 데스크톱 빌드
|
||||
pnpm tauri build
|
||||
|
||||
# Lint
|
||||
pnpm eslint .
|
||||
|
||||
# src-tauri/ 에서 실행
|
||||
# Rust 검사 (src-tauri/에서 실행)
|
||||
cargo check
|
||||
cargo clippy
|
||||
cargo build
|
||||
```
|
||||
|
||||
## 아키텍처
|
||||
|
||||
```text
|
||||
Next.js 16 (Static Export) + React 19
|
||||
|
|
||||
| invoke()
|
||||
v
|
||||
Tauri 2 Commands (Rust)
|
||||
|- ACP Manager
|
||||
|- Parsers (local session ingestion)
|
||||
|- Git / File Tree / Terminal runtime
|
||||
|- MCP marketplace + local config writer
|
||||
|- SeaORM + SQLite
|
||||
|
|
||||
v
|
||||
Local Filesystem / Local Agent Data / Git Repos
|
||||
```
|
||||
|
||||
## 제약 사항
|
||||
|
||||
- 프론트엔드는 정적 내보내기 사용 (`output: "export"`)
|
||||
- Next.js 동적 라우트 (`[param]`) 불가; 대신 쿼리 파라미터 사용
|
||||
- Tauri 명령 파라미터: 프론트엔드 `camelCase`, Rust `snake_case`
|
||||
- TypeScript strict 모드
|
||||
|
||||
## 개인정보 보호 및 보안
|
||||
|
||||
- 파싱, 저장, 프로젝트 작업은 기본적으로 로컬 우선
|
||||
- 네트워크 접근은 사용자가 명시적으로 작업을 실행할 때만 발생
|
||||
- 엔터프라이즈 환경을 위한 시스템 프록시 지원
|
||||
|
||||
## 라이선스
|
||||
|
||||
Apache-2.0. `LICENSE` 참고.
|
||||
|
||||
@@ -2,6 +2,8 @@
|
||||
|
||||
[](https://github.com/xintaofei/codeg/releases)
|
||||
[](../../LICENSE)
|
||||
[](https://tauri.app/)
|
||||
[](https://nextjs.org/)
|
||||
|
||||
<p>
|
||||
<a href="../../README.md">English</a> |
|
||||
@@ -16,57 +18,139 @@
|
||||
<a href="./README.ar.md">العربية</a>
|
||||
</p>
|
||||
|
||||
Codeg (Code Generation) é um workspace empresarial para geração de código com
|
||||
múltiplos Agent.
|
||||
Ele unifica agentes locais como Claude Code, Codex CLI, OpenCode e Gemini CLI
|
||||
em um único app desktop com agregação de sessões, desenvolvimento paralelo com
|
||||
`git worktree`, gestão de MCP/Skills e fluxo integrado de Git/arquivos/terminal.
|
||||
Codeg (Code Generation) é um workspace de codificação multi-agentes de nível empresarial.
|
||||
Ele unifica agentes de codificação IA locais (Claude Code, Codex CLI, OpenCode, Gemini CLI,
|
||||
OpenClaw, etc.) em um único aplicativo desktop com agregação de sessões, desenvolvimento
|
||||
paralelo via `git worktree`, gerenciamento de MCP/Skills e fluxos integrados de Git/arquivos/terminal.
|
||||
|
||||
## Interface principal
|
||||
|
||||
|
||||
|
||||
|
||||
## Exibição em mosaico de sessões
|
||||
|
||||
## Exibição em mosaico das sessões
|
||||
|
||||
|
||||
|
||||
> Versão atual: `v0.1.x` (iteração rápida)
|
||||
> Status atual: `v0.1.x` (iteração rápida, adequado para adotantes iniciais)
|
||||
|
||||
## Destaques
|
||||
|
||||
- Workspace unificado para múltiplos Agent
|
||||
- Agregação local de sessões com visualização estruturada
|
||||
- Desenvolvimento paralelo com `git worktree`
|
||||
- Gestão de MCP (varredura local + busca/instalação)
|
||||
- Gestão de Skills (global e por projeto)
|
||||
- Workspace multi-agentes unificado no mesmo projeto
|
||||
- Ingestão local de sessões com renderização estruturada
|
||||
- Desenvolvimento paralelo com fluxos `git worktree` integrados
|
||||
- Gerenciamento de MCP (varredura local + busca/instalação no registro)
|
||||
- Gerenciamento de Skills (escopo global e por projeto)
|
||||
- Ciclo de engenharia integrado (árvore de arquivos, diff, alterações git, commit, terminal)
|
||||
|
||||
## Escopo suportado
|
||||
|
||||
### 1) Ingestão de sessões (sessões históricas)
|
||||
|
||||
| Agente | Caminho por variável de ambiente | Padrão macOS / Linux | Padrão Windows |
|
||||
| --- | --- | --- | --- |
|
||||
| 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` |
|
||||
|
||||
> Nota: as variáveis de ambiente têm prioridade sobre os caminhos padrão.
|
||||
|
||||
### 2) Sessões em tempo real ACP
|
||||
|
||||
O registro integrado inclui mais de 20 adaptadores, como Claude Code, Codex CLI,
|
||||
Gemini CLI, OpenCode, OpenClaw, GitHub Copilot, Cline, Qwen Code, entre outros.
|
||||
|
||||
### 3) Suporte a configurações de Skills
|
||||
|
||||
- Suportado: `Claude Code / Codex / OpenCode / Gemini CLI / OpenClaw`
|
||||
- Mais adaptadores serão adicionados progressivamente
|
||||
|
||||
### 4) Aplicativos alvo MCP
|
||||
|
||||
Alvos de escrita atuais:
|
||||
|
||||
- Claude Code
|
||||
- Codex
|
||||
- OpenCode
|
||||
|
||||
## Início rápido
|
||||
|
||||
### Requisitos
|
||||
|
||||
- Node.js `>=22`
|
||||
- Node.js `>=22` (recomendado)
|
||||
- pnpm `>=10`
|
||||
- Rust stable (2021 edition)
|
||||
- Dependências de build do Tauri 2
|
||||
|
||||
### Comandos
|
||||
Exemplo Linux (Debian/Ubuntu):
|
||||
|
||||
```bash
|
||||
sudo apt-get update
|
||||
sudo apt-get install -y \
|
||||
libwebkit2gtk-4.1-dev \
|
||||
libayatana-appindicator3-dev \
|
||||
librsvg2-dev \
|
||||
patchelf
|
||||
```
|
||||
|
||||
### Desenvolvimento
|
||||
|
||||
```bash
|
||||
pnpm install
|
||||
|
||||
# Aplicativo desktop completo (Tauri + Next.js)
|
||||
pnpm tauri dev
|
||||
|
||||
# Apenas frontend
|
||||
pnpm dev
|
||||
|
||||
# Exportação estática do frontend para out/
|
||||
pnpm build
|
||||
|
||||
# Build do aplicativo desktop
|
||||
pnpm tauri build
|
||||
|
||||
# Lint
|
||||
pnpm eslint .
|
||||
|
||||
# Executar em src-tauri/
|
||||
# Verificações Rust (executar em src-tauri/)
|
||||
cargo check
|
||||
cargo clippy
|
||||
cargo build
|
||||
```
|
||||
|
||||
## Arquitetura
|
||||
|
||||
```text
|
||||
Next.js 16 (Static Export) + React 19
|
||||
|
|
||||
| invoke()
|
||||
v
|
||||
Tauri 2 Commands (Rust)
|
||||
|- ACP Manager
|
||||
|- Parsers (local session ingestion)
|
||||
|- Git / File Tree / Terminal runtime
|
||||
|- MCP marketplace + local config writer
|
||||
|- SeaORM + SQLite
|
||||
|
|
||||
v
|
||||
Local Filesystem / Local Agent Data / Git Repos
|
||||
```
|
||||
|
||||
## Restrições
|
||||
|
||||
- O frontend usa exportação estática (`output: "export"`)
|
||||
- Sem rotas dinâmicas do Next.js (`[param]`); use parâmetros de consulta em vez disso
|
||||
- Parâmetros de comandos Tauri: `camelCase` no frontend, `snake_case` no Rust
|
||||
- TypeScript em modo strict
|
||||
|
||||
## Privacidade e segurança
|
||||
|
||||
- Local-first por padrão para análise, armazenamento e operações do projeto
|
||||
- O acesso à rede ocorre apenas em ações iniciadas pelo usuário
|
||||
- Suporte a proxy do sistema para ambientes corporativos
|
||||
|
||||
## Licença
|
||||
|
||||
Apache-2.0. Veja `LICENSE`.
|
||||
|
||||
@@ -2,6 +2,8 @@
|
||||
|
||||
[](https://github.com/xintaofei/codeg/releases)
|
||||
[](../../LICENSE)
|
||||
[](https://tauri.app/)
|
||||
[](https://nextjs.org/)
|
||||
|
||||
<p>
|
||||
<a href="../../README.md">English</a> |
|
||||
@@ -16,29 +18,29 @@
|
||||
<a href="./README.ar.md">العربية</a>
|
||||
</p>
|
||||
|
||||
Codeg（Code Generation）是一个面向多 Agent 的企业级代码生成工作台。
|
||||
它把 Claude Code、Codex CLI、OpenCode、Gemini CLI 等本地 AI 编码代理统一到一个桌面应用中，支持会话聚合、并行 `git worktree` 开发、MCP/Skills 管理，以及 Git/文件/终端一体化工作流。
|
||||
Codeg（Code Generation）是一个企业级多 Agent 编码工作台。
|
||||
它将本地 AI 编码代理（Claude Code、Codex CLI、OpenCode、Gemini CLI、
|
||||
OpenClaw 等）统一到一个桌面应用中，支持会话聚合、并行 `git worktree`
|
||||
开发、MCP/Skills 管理，以及集成的 Git/文件/终端工作流。
|
||||
|
||||
## 主界面
|
||||
|
||||
|
||||
|
||||
|
||||
## 会话平铺显示
|
||||
|
||||
|
||||
|
||||
|
||||
> 当前版本：`v0.1.x`（快速迭代中）
|
||||
> 当前状态：`v0.1.x`（快速迭代中，适合早期使用者）
|
||||
|
||||
## 核心亮点
|
||||
|
||||
- 多 Agent 统一工作台
|
||||
- 本地会话聚合与结构化展示
|
||||
- 内置 `git worktree` 并行开发
|
||||
- 同一项目中的多 Agent 统一工作台
|
||||
- 本地会话解析与结构化渲染
|
||||
- 内置 `git worktree` 并行开发流程
|
||||
- MCP 管理（本地扫描 + 市场搜索/安装）
|
||||
- Skills 管理（全局与项目级）
|
||||
- 文件树、Diff、Git、提交、终端一体化
|
||||
- 集成工程闭环（文件树、Diff、Git 变更、提交、终端）
|
||||
|
||||
## 支持范围
|
||||
|
||||
@@ -50,46 +52,75 @@ Codeg（Code Generation）是一个面向多 Agent 的企业级代码生成工
|
||||
| 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` |
|
||||
|
||||
> 注意：环境变量的优先级高于默认路径。
|
||||
|
||||
### 2) ACP 实时会话
|
||||
|
||||
内置 20+ Agent 适配器（如 Claude Code、Codex CLI、Gemini CLI、OpenCode、OpenClaw 等）。
|
||||
内置注册表包含 20+ 适配器，如 Claude Code、Codex CLI、
|
||||
Gemini CLI、OpenCode、OpenClaw、GitHub Copilot、Cline、Qwen Code 等。
|
||||
|
||||
### 3) Skills 设置页支持
|
||||
### 3) Skills 设置支持
|
||||
|
||||
- 已支持：`Claude Code / Codex / OpenCode / Gemini CLI / OpenClaw`
|
||||
- 其他代理将持续补齐
|
||||
- 更多适配器将持续补齐
|
||||
|
||||
### 4) MCP 目标应用
|
||||
|
||||
当前支持写入：Claude Code、Codex、OpenCode。
|
||||
当前可写入的目标：
|
||||
|
||||
- Claude Code
|
||||
- Codex
|
||||
- OpenCode
|
||||
|
||||
## 快速开始
|
||||
|
||||
### 环境要求
|
||||
|
||||
- Node.js `>=22`
|
||||
- Node.js `>=22`（推荐）
|
||||
- pnpm `>=10`
|
||||
- Rust stable（2021 edition）
|
||||
- Tauri 2 构建依赖
|
||||
|
||||
Linux（Debian/Ubuntu）示例：
|
||||
|
||||
```bash
|
||||
sudo apt-get update
|
||||
sudo apt-get install -y \
|
||||
libwebkit2gtk-4.1-dev \
|
||||
libayatana-appindicator3-dev \
|
||||
librsvg2-dev \
|
||||
patchelf
|
||||
```
|
||||
|
||||
### 开发命令
|
||||
|
||||
```bash
|
||||
pnpm install
|
||||
|
||||
# 完整桌面应用（Tauri + Next.js）
|
||||
pnpm tauri dev
|
||||
|
||||
# 仅前端
|
||||
pnpm dev
|
||||
|
||||
# 前端静态导出到 out/
|
||||
pnpm build
|
||||
|
||||
# 桌面应用构建
|
||||
pnpm tauri build
|
||||
|
||||
# Lint
|
||||
pnpm eslint .
|
||||
|
||||
# 在 src-tauri/ 下执行
|
||||
# Rust 检查（在 src-tauri/ 下执行）
|
||||
cargo check
|
||||
cargo clippy
|
||||
cargo build
|
||||
```
|
||||
|
||||
## 架构概览
|
||||
## 架构
|
||||
|
||||
```text
|
||||
Next.js 16 (Static Export) + React 19
|
||||
@@ -98,24 +129,27 @@ Next.js 16 (Static Export) + React 19
|
||||
v
|
||||
Tauri 2 Commands (Rust)
|
||||
|- ACP Manager
|
||||
|- Parsers
|
||||
|- Git / File Tree / Terminal
|
||||
|- Parsers (local session ingestion)
|
||||
|- Git / File Tree / Terminal runtime
|
||||
|- MCP marketplace + local config writer
|
||||
|- SeaORM + SQLite
|
||||
|
|
||||
v
|
||||
Local Filesystem / Local Agent Data / Git Repos
|
||||
```
|
||||
|
||||
## 开发约束
|
||||
|
||||
- 前端静态导出（`output: "export"`）
|
||||
- 不使用动态路由（`[param]`），统一查询参数
|
||||
- 前端参数 `camelCase`，Rust 参数 `snake_case`
|
||||
- TypeScript strict
|
||||
- 前端使用静态导出（`output: "export"`）
|
||||
- 不使用 Next.js 动态路由（`[param]`），统一使用查询参数
|
||||
- Tauri 命令参数：前端 `camelCase`，Rust `snake_case`
|
||||
- TypeScript strict 模式
|
||||
|
||||
## 隐私与安全
|
||||
|
||||
- 默认本地优先
|
||||
- 仅在用户触发时访问网络
|
||||
- 支持系统代理
|
||||
- 默认本地优先：解析、存储、项目操作均在本地完成
|
||||
- 仅在用户主动触发时才访问网络
|
||||
- 支持系统代理，适配企业网络环境
|
||||
|
||||
## 许可证
|
||||
|
||||
|
||||
@@ -2,6 +2,8 @@
|
||||
|
||||
[](https://github.com/xintaofei/codeg/releases)
|
||||
[](../../LICENSE)
|
||||
[](https://tauri.app/)
|
||||
[](https://nextjs.org/)
|
||||
|
||||
<p>
|
||||
<a href="../../README.md">English</a> |
|
||||
@@ -16,29 +18,29 @@
|
||||
<a href="./README.ar.md">العربية</a>
|
||||
</p>
|
||||
|
||||
Codeg（Code Generation）是面向多 Agent 的企業級程式碼生成工作台。
|
||||
它將 Claude Code、Codex CLI、OpenCode、Gemini CLI 等本地 AI 編碼代理整合到一個桌面應用，支援會話彙整、並行 `git worktree` 開發、MCP/Skills 管理，以及 Git/檔案/終端整合流程。
|
||||
Codeg（Code Generation）是一個企業級多 Agent 編碼工作台。
|
||||
它將本地 AI 編碼代理（Claude Code、Codex CLI、OpenCode、Gemini CLI、
|
||||
OpenClaw 等）整合到一個桌面應用中，支援會話彙整、並行 `git worktree`
|
||||
開發、MCP/Skills 管理，以及整合的 Git/檔案/終端工作流。
|
||||
|
||||
## 主介面
|
||||
|
||||
|
||||
|
||||
|
||||
## 會話平鋪顯示
|
||||
|
||||
|
||||
|
||||
|
||||
> 目前版本：`v0.1.x`（快速迭代中）
|
||||
> 目前狀態：`v0.1.x`（快速迭代中，適合早期使用者）
|
||||
|
||||
## 核心亮點
|
||||
|
||||
- 多 Agent 統一工作台
|
||||
- 本地會話彙整與結構化顯示
|
||||
- 內建 `git worktree` 並行開發
|
||||
- 同一專案中的多 Agent 統一工作台
|
||||
- 本地會話解析與結構化渲染
|
||||
- 內建 `git worktree` 並行開發流程
|
||||
- MCP 管理（本地掃描 + 市場搜尋/安裝）
|
||||
- Skills 管理（全域與專案級）
|
||||
- 檔案樹、Diff、Git、提交、終端一體化
|
||||
- 整合工程閉環（檔案樹、Diff、Git 變更、提交、終端）
|
||||
|
||||
## 支援範圍
|
||||
|
||||
@@ -50,46 +52,75 @@ Codeg（Code Generation）是面向多 Agent 的企業級程式碼生成工作
|
||||
| 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` |
|
||||
|
||||
> 注意：環境變數的優先順序高於預設路徑。
|
||||
|
||||
### 2) ACP 即時會話
|
||||
|
||||
內建 20+ Agent 適配器（如 Claude Code、Codex CLI、Gemini CLI、OpenCode、OpenClaw 等）。
|
||||
內建註冊表包含 20+ 適配器，如 Claude Code、Codex CLI、
|
||||
Gemini CLI、OpenCode、OpenClaw、GitHub Copilot、Cline、Qwen Code 等。
|
||||
|
||||
### 3) Skills 設定頁支援
|
||||
### 3) Skills 設定支援
|
||||
|
||||
- 已支援：`Claude Code / Codex / OpenCode / Gemini CLI / OpenClaw`
|
||||
- 其他代理持續補齊
|
||||
- 更多適配器將持續補齊
|
||||
|
||||
### 4) MCP 目標應用
|
||||
|
||||
目前支援寫入：Claude Code、Codex、OpenCode。
|
||||
目前可寫入的目標：
|
||||
|
||||
- Claude Code
|
||||
- Codex
|
||||
- OpenCode
|
||||
|
||||
## 快速開始
|
||||
|
||||
### 環境需求
|
||||
|
||||
- Node.js `>=22`
|
||||
- Node.js `>=22`（建議）
|
||||
- pnpm `>=10`
|
||||
- Rust stable（2021 edition）
|
||||
- Tauri 2 建置依賴
|
||||
|
||||
Linux（Debian/Ubuntu）範例：
|
||||
|
||||
```bash
|
||||
sudo apt-get update
|
||||
sudo apt-get install -y \
|
||||
libwebkit2gtk-4.1-dev \
|
||||
libayatana-appindicator3-dev \
|
||||
librsvg2-dev \
|
||||
patchelf
|
||||
```
|
||||
|
||||
### 開發命令
|
||||
|
||||
```bash
|
||||
pnpm install
|
||||
|
||||
# 完整桌面應用（Tauri + Next.js）
|
||||
pnpm tauri dev
|
||||
|
||||
# 僅前端
|
||||
pnpm dev
|
||||
|
||||
# 前端靜態匯出到 out/
|
||||
pnpm build
|
||||
|
||||
# 桌面應用建置
|
||||
pnpm tauri build
|
||||
|
||||
# Lint
|
||||
pnpm eslint .
|
||||
|
||||
# 在 src-tauri/ 下執行
|
||||
# Rust 檢查（在 src-tauri/ 下執行）
|
||||
cargo check
|
||||
cargo clippy
|
||||
cargo build
|
||||
```
|
||||
|
||||
## 架構概覽
|
||||
## 架構
|
||||
|
||||
```text
|
||||
Next.js 16 (Static Export) + React 19
|
||||
@@ -98,24 +129,27 @@ Next.js 16 (Static Export) + React 19
|
||||
v
|
||||
Tauri 2 Commands (Rust)
|
||||
|- ACP Manager
|
||||
|- Parsers
|
||||
|- Git / File Tree / Terminal
|
||||
|- Parsers (local session ingestion)
|
||||
|- Git / File Tree / Terminal runtime
|
||||
|- MCP marketplace + local config writer
|
||||
|- SeaORM + SQLite
|
||||
|
|
||||
v
|
||||
Local Filesystem / Local Agent Data / Git Repos
|
||||
```
|
||||
|
||||
## 開發約束
|
||||
|
||||
- 前端靜態匯出（`output: "export"`）
|
||||
- 不使用動態路由（`[param]`），改用查詢參數
|
||||
- 前端參數 `camelCase`，Rust 參數 `snake_case`
|
||||
- TypeScript strict
|
||||
- 前端使用靜態匯出（`output: "export"`）
|
||||
- 不使用 Next.js 動態路由（`[param]`），改用查詢參數
|
||||
- Tauri 命令參數：前端 `camelCase`，Rust `snake_case`
|
||||
- TypeScript strict 模式
|
||||
|
||||
## 隱私與安全
|
||||
|
||||
- 預設本地優先
|
||||
- 僅在使用者觸發時連網
|
||||
- 支援系統代理
|
||||
- 預設本地優先：解析、儲存、專案操作均在本地完成
|
||||
- 僅在使用者主動觸發時才存取網路
|
||||
- 支援系統代理，適配企業網路環境
|
||||
|
||||
## 授權
|
||||
|
||||
|
||||
Reference in New Issue
Block a user