Codeg

Crea nuevos proyectos visualmente con una interfaz de panel dividido: configura a la izquierda, vista previa en tiempo real a la derecha.

Qué ofrece

• Configuración visual — selecciona estilo, tema de color, biblioteca de iconos, fuente, radio de borde y más desde menús desplegables; la vista previa se actualiza instantáneamente
• Vista previa en vivo — visualiza el aspecto elegido renderizado en tiempo real antes de crear nada
• Creación con un clic — presiona "Crear proyecto" y el launcher ejecuta shadcn init con tu preset, plantilla de framework (Next.js / Vite / React Router / Astro / Laravel) y gestor de paquetes (pnpm / npm / yarn / bun)
• Detección de gestores de paquetes — verifica automáticamente qué gestores están instalados y muestra sus versiones
• Integración fluida — el proyecto recién creado se abre directamente en el workspace de Codeg

Actualmente soporta scaffolding de proyectos shadcn/ui, con un diseño basado en pestañas preparado para más tipos de proyectos en el futuro.

Conecta tus aplicaciones de mensajería favoritas — Telegram, Lark (Feishu), iLink (Weixin) y más — a tus agentes de codificación IA. Crea tareas, envía mensajes de seguimiento, aprueba permisos, reanuda sesiones y monitorea la actividad directamente desde el chat — recibe respuestas del agente en tiempo real con detalles de llamadas a herramientas, solicitudes de permisos y resúmenes de finalización sin necesidad de abrir un navegador.

Los supergrupos de foro de Telegram también pueden usar Telegram topic mode para vincular cada topic a una sesión de Codeg independiente.

Canales soportados

Se planean más canales (Discord, Slack, DingTalk, etc.) para futuras versiones.

Trabaja con archivos Word, Excel y PowerPoint como un flujo de trabajo de primera clase. El toolset officecli integrado permite a tus agentes crear, analizar, revisar y editar documentos .docx, .xlsx y .pptx — y puedes previsualizar el resultado directamente en Codeg.

Qué ofrece

• Crear y editar — genera nuevos documentos o modifica .docx / .xlsx / .pptx existentes, incluyendo gráficos, tablas y formato
• Analizar y revisar — inspecciona la estructura del documento, detecta problemas de formato y revisa el contenido
• Vista previa en vivo — abre un .docx / .xlsx / .pptx en una pestaña de archivo y se renderiza en línea, actualizándose automáticamente mientras el agente edita — respaldado por un servidor officecli watch permanente (con proxy inverso y autenticación por capacidad para entornos web y servidor)
• Acciones rápidas — la página de bienvenida ofrece pestañas de Codificación, Office e Investigación científica que insertan la invocación de habilidad correspondiente y una plantilla de prompt con un solo clic; las habilidades no habilitadas muestran un badge de bloqueo y enlazan a donde puedes activarlas
• Configuración de Office Tools — una página de ajustes dedicada instala officecli y gestiona sus habilidades mediante una matriz de habilidad×agente: alterna cualquier par (habilidad, agente) y aplica cambios masivos

Convierte cualquier agente en un asistente de investigación riguroso. Codeg incluye un conjunto curado de habilidades de investigación científica con licencia MIT — desde la ideación hasta el análisis y la redacción — que se instalan en el almacén central de habilidades compartido y se vinculan a los agentes que elijas, exactamente igual que los toolsets de expertos y de office.

Qué ofrece

• Habilidades curadas — generación de hipótesis, diseño experimental, potencia estadística, análisis estadístico, análisis exploratorio de datos, visualización científica, evaluación crítica, revisión por pares, gestión de citas, evaluación de académicos, búsqueda de artículos y esquemas de IA
• Acciones rápidas — la pestaña de Investigación científica de la página de bienvenida inserta la invocación de habilidad correspondiente junto con una plantilla de prompt localizada en el compositor con un solo clic
• Configuración de Ciencia — una página de ajustes dedicada gestiona las habilidades mediante una matriz de habilidad×agente, con badges que señalan las habilidades que necesitan una clave de API o un entorno de Python

Convierte cualquier configuración del compositor — agente, modelo, prompt, directorio de trabajo y opciones — en una Automatización reutilizable que se ejecuta sin abrir la interfaz.

Qué ofrece

• Configurar una vez, reutilizar siempre — guarda una configuración completa del compositor como automatización con nombre
• Programada o bajo demanda — ejecútala según un horario cron o lánzala manualmente cuando lo necesites
• Ejecución desatendida — las automatizaciones se ejecutan en segundo plano y crean sesiones reales que puedes abrir en el workspace en cualquier momento; tras iniciarlas, regresan automáticamente al workspace

Requisitos

• Node.js >=22 (recomendado)
• pnpm >=10
• Rust stable (2021 edition)
• Dependencias de compilación de Tauri 2 (solo modo escritorio)

Ejemplo para Linux (Debian/Ubuntu):

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

Binarios

Codeg distribuye tres binarios de Rust desde un único workspace:

codeg-mcp debe ubicarse junto a su binario padre en tiempo de ejecución — los instaladores, la imagen Docker y el empaquetador de sidecars de Tauri lo colocan junto a codeg / codeg-server. Las compilaciones desde fuente y los diseños personalizados pueden anular la búsqueda con la variable de entorno CODEG_MCP_BIN=/abs/path/codeg-mcp. Si el compañero falta, la delegación se omite (se registra una única advertencia) y el resto de la sesión del agente sigue funcionando.

Desarrollo

pnpm install

# Solo frontend (servidor de desarrollo de Next.js, sin Rust)
pnpm dev

# Exportación estática del frontend a out/
pnpm build

# Aplicación de escritorio completa (Tauri + Next.js, compila automáticamente el sidecar codeg-mcp)
pnpm tauri dev

# Compilación de escritorio de release (incluye codeg-mcp como externalBin)
pnpm tauri build

# Servidor independiente (sin Tauri/GUI necesario)
pnpm server:dev
pnpm server:build                  # binario de release en src-tauri/target/release/codeg-server

# Compilar explícitamente el compañero codeg-mcp (para el triple del host)
pnpm tauri:prepare-sidecars        # salida: src-tauri/binaries/codeg-mcp-<triple>

# Saltar la preparación del sidecar al iterar el frontend cuando no necesitas delegación
CODEG_SKIP_SIDECAR=1 pnpm tauri dev

# Lint
pnpm eslint .

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

# Verificaciones de Rust (ejecutar en src-tauri/)
cargo check                                                     # escritorio (features por defecto)
cargo check --no-default-features --bin codeg-server            # modo servidor
cargo check --no-default-features --bin codeg-mcp               # compañero MCP
cargo clippy --all-targets --features test-utils -- -D warnings

# Pruebas de Rust
cargo test --features test-utils                                # escritorio (incl. integración)
cargo test --no-default-features --bin codeg-server --lib       # modo servidor
cargo insta review                                              # aceptar actualizaciones de snapshots del parser

Sugerencia: cuando tengas una compilación reciente de codeg-mcp en src-tauri/target/release/ y quieras apuntar un codeg-server lanzado manualmente sin reinstalar, exporta CODEG_MCP_BIN=$(pwd)/src-tauri/target/release/codeg-mcp.

Despliegue del servidor

Codeg puede ejecutarse como un servidor web independiente sin entorno de escritorio.

Opción 1: Instalación en una línea (Linux / macOS)

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

Instalar una versión específica o en un directorio personalizado:

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

Luego ejecutar:

codeg-server

Opción 2: Instalación en una línea (Windows PowerShell)

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

O instalar una versión específica:

.\install.ps1 -Version v0.5.2

Opción 3: Descargar desde GitHub Releases

Los binarios precompilados (con recursos web incluidos) están disponibles en la página de Releases:

# Ejemplo: descargar, extraer y ejecutar
tar xzf codeg-server-linux-x64.tar.gz
cd codeg-server-linux-x64
CODEG_STATIC_DIR=./web ./codeg-server

Para despliegues desatendidos, inícialo con --supervise para que una actualización in situ fallida se revierta automáticamente — consulta Actualizaciones in situ.

Opción 4: Docker

# Usando Docker Compose (recomendado)
docker compose up -d

# O ejecutar directamente con Docker
docker run -d -p 3080:3080 -v codeg-data:/data ghcr.io/xintaofei/codeg:latest

# Con token personalizado y directorio de proyecto montado
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

La imagen Docker utiliza una compilación multi-etapa (Node.js + Rust → runtime Debian slim) e incluye git y ssh para operaciones con repositorios. Los datos se persisten en el volumen /data. Opcionalmente, puedes montar directorios de proyecto para acceder a repositorios locales desde el contenedor.

Opción 5: Compilar desde el código fuente

pnpm install && pnpm build          # compilar frontend
cd src-tauri
cargo build --release --bin codeg-server --no-default-features
cargo build --release --bin codeg-mcp --no-default-features    # compañero de delegación
CODEG_STATIC_DIR=../out ./target/release/codeg-server          # codeg-mcp se detecta como hermano

Si mantienes los dos binarios en directorios separados, define CODEG_MCP_BIN=/abs/path/to/codeg-mcp para que el runtime pueda seguir encontrando el compañero; sin esto, la delegación multi-agente se desactiva silenciosamente.

Actualizaciones in situ

El servidor puede actualizarse a sí mismo desde Ajustes → Actualización de software: descarga la versión firmada para su plataforma, reemplaza los binarios y los recursos web en disco, y se reinicia — sin necesidad de volver a desplegar manualmente. Esto es solo para Linux/macOS (desactivado en Windows). La versión anterior se conserva como copia de seguridad, por lo que la misma pantalla ofrece una acción Revertir para volver a ella.

Ejecuta bajo el supervisor para la reversión automática. Inicia el servidor independiente con --supervise para que un proceso recién actualizado que no arranque dentro de la ventana de prueba se revierta automáticamente a la versión anterior:

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

Sin --supervise el servidor sigue actualizándose in situ (se vuelve a ejecutar a sí mismo), pero la actualización es de mejor esfuerzo: no hay ningún supervisor que revierta automáticamente una versión que no puede arrancar. La imagen Docker ya se ejecuta bajo el supervisor.

Las actualizaciones en Docker cambian el contenedor, no la imagen. Una actualización in situ reescribe los binarios y los recursos web dentro de la capa de escritura del contenedor en ejecución, por lo que solo existen en ese contenedor. El volumen /data persiste, pero los archivos actualizados no: recrear el contenedor — docker compose up --force-recreate, un nuevo docker run, o recrearlo tras un docker pull — vuelve a partir de la imagen y descarta la actualización in situ. (Un docker pull por sí solo únicamente actualiza la imagen local; nada se revierte hasta que se recrea el contenedor.) Para que una actualización sea permanente, compila o descarga una imagen con la nueva versión y recrea el contenedor a partir de ella.

Configuración

Variables de entorno:

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)