+ Plano de control autoalojado para agentes de código IA.
++ Pixcode te permite ejecutar CLIs de código IA, inspeccionar archivos, gestionar shell y control de versiones, + orquestar equipos de agentes, automatizar mediante APIs y mantener el trabajo de larga ejecución activo desde + tu propia computadora o servidor. +
+
+ 
+ 
+ 
+
+ Sitio web · + Lanzamientos · + Documentación · + OpenAPI · + Contribuir +
+ +
| 
|
+
+| Selección de CLI | Herramientas y MCP |
+| --- | --- |
+| 
| 
|
+
+## Características principales
+
+### Espacio de trabajo para agentes multi-CLI
+
+Pixcode otorga a cada CLI de código compatible un espacio de trabajo compartido sin ocultar el
+comportamiento nativo del proveedor. Puedes conectar los proveedores que ya utilizas y alternar
+entre ellos desde el mismo proyecto.
+
+- Claude Code
+- Cursor CLI
+- OpenAI Codex
+- Gemini CLI
+- Qwen Code
+- OpenCode
+
+Los paneles del proveedor cubren el estado de autenticación, verificaciones de instalación, versiones de CLI, selección de modelos,
+soporte MCP e historial de sesiones. Cuando un agente está pensando, ejecutando herramientas,
+esperando aprobación o escribiendo salida, la interfaz mantiene un estado de procesamiento visible
+en lugar de dejar la pantalla con una sensación de congelación.
+
+### Chat diseñado para el trabajo de desarrollo
+
+El chat de Pixcode es consciente del proyecto y está diseñado para sesiones de codificación de larga duración.
+
+- Compositor fijo en la parte inferior en pantallas de chat/proyecto.
+- Historial de sesiones por proveedor y proyecto.
+- Modos por defecto, planificación y ejecución cuando están soportados.
+- Entrada amigable con comandos `/`.
+- Renderizado de salida de herramientas para planes, operaciones de archivos, salida de comandos y eventos de estado
+ del proveedor.
+- Notificaciones de Telegram y de navegador/escritorio cuando el trabajo finaliza, falla o necesita
+ atención.
+
+### Archivos, shell y control de versiones
+
+Los paneles laterales están construidos alrededor de la forma en que los agentes de código modifican los proyectos.
+
+- Panel de archivos con vistas detalladas y compactas.
+- Flujos de apertura/edición de archivos que preservan la superficie principal de chat u orquestación.
+- Panel de shell con comportamiento dividido/total en escritorio y comportamiento seguro para móviles en
+ pantallas más pequeñas.
+- Panel de Control de Versiones para estado de Git, diffs, ramas, commits y archivos cambiados cuando un proyecto es un repositorio Git.
+- Seguimiento de cambios local para proyectos que no son repositorios Git.
+
+### Centro de Comandos para archivos modificados
+
+El Centro de Comandos vigila qué cambia mientras los agentes trabajan. Puede rastrear cambios de Git
+o cambios en el sistema de archivos local, mostrar la lista de archivos modificados junto al chat activo,
+resaltar los elementos cambiados y abrir el archivo editado en la ubicación relevante.
+
+Esto está pensado para responder a la pregunta práctica: "¿Qué acabó de tocar el agente?"
+
+### Orquestación multi-agente
+
+Pixcode puede ejecutar flujos de trabajo estructurados de agentes en lugar de enviar cada indicación a un
+solo agente.
+
+Los estilos de flujo de trabajo integrados incluyen:
+
+- Equipo de Agentes: dividir una tarea entre implementación, revisión, documentación, pruebas o
+ roles personalizados.
+- Traspaso Secuencial: pasar un contexto compacto de una etapa a la siguiente.
+- Revisión Multi-modelo: comparar opiniones de proveedores/modelos sobre el mismo código o plan.
+- Debate de Decisiones: hacer que múltiples agentes discutan enfoques antes de actuar.
+
+Los controles de orquestación incluyen:
+
+- selección de proveedor y modelo por agente,
+- etiquetas, roles e instrucciones personalizadas,
+- duplicación de proveedores cuando múltiples trabajadores deben usar el mismo CLI,
+- selección de CLI alternativo para pasos fallidos,
+- vista previa de ejecución antes de la ejecución,
+- salida de pasos en streaming e informe final,
+- paneles de configuración/salida redimensionables.
+
+### Orquestación en segundo plano
+
+Pixcode incluye un plano de control de orquestación consciente del proyecto para trabajo de agentes en segundo
+plano. Se ejecuta dentro de la instancia actual de Pixcode, comprende el contexto activo
+del proyecto y puede enrutar tareas delimitadas a Claude Code, Codex, Cursor,
+Gemini, Qwen o OpenCode a través de adaptadores CLI orientados a terminal.
+
+Los controles de orquestación incluyen:
+
+- contexto de tarea con alcance al proyecto,
+- enrutamiento por proveedor/modelo,
+- estado y artefactos de tarea en streaming,
+- coordinación de ejecución de flujos de trabajo,
+- verificaciones y vistas previas en segundo plano,
+- APIs locales autenticadas bajo `/api/orchestration`.
+
+### Automatización con enfoque en API
+
+El frontend de Pixcode usa el mismo plano de control de backend expuesto a la automatización
+externa. Genera una clave API `px_` y llama a las APIs REST/WebSocket desde tus
+propias herramientas, scripts, CI, paneles o puente de Telegram.
+
+Listar proyectos:
+
+```bash
+curl http://localhost:3001/api/projects \
+ -H "Authorization: Bearer px_your_key_here"
+```
+
+Ejecutar una tarea de proveedor:
+
+```bash
+curl http://localhost:3001/api/agent \
+ -H "Authorization: Bearer px_your_key_here" \
+ -H "Content-Type: application/json" \
+ -d '{
+ "provider": "codex",
+ "projectPath": "/home/me/project",
+ "message": "Review the current diff and list risky changes.",
+ "stream": false
+ }'
+```
+
+Vista previa de un flujo de trabajo de orquestación:
+
+```bash
+curl http://localhost:3001/api/orchestration/workflows/agent_team/preview \
+ -H "Authorization: Bearer px_your_key_here" \
+ -H "Content-Type: application/json" \
+ -d '{
+ "metadata": {
+ "agents": [
+ { "adapterId": "codex", "label": "Backend", "role": "backend" },
+ { "adapterId": "opencode", "label": "Reviewer", "role": "review" }
+ ]
+ }
+ }'
+```
+
+Las claves heredadas `ck_` siguen siendo aceptadas para instalaciones anteriores, pero `px_` es el
+prefijo actual.
+
+Referencia OpenAPI: [`public/openapi.yaml`](public/openapi.yaml)
+
+### Telegram, notificaciones y control remoto
+
+Pixcode puede vincular un chat de Telegram con tu cuenta para que las tareas completadas, ejecuciones fallidas
+y estados que requieren acción puedan llegar a ti fuera del navegador. El objetivo
+no es solo una notificación final: el puente de Telegram es una superficie de control para
+indicaciones remotas, selección de proveedor/sesión y trabajo de larga duración.
+
+Las superficies de notificación incluyen:
+
+- alertas dentro de la aplicación,
+- notificaciones de navegador/escritorio donde la plataforma lo permita,
+- notificaciones de tareas de Telegram,
+- avisos de actualización y notas de lanzamiento.
+
+### Sistema de temas
+
+Pixcode cuenta con un sistema de apariencia real en lugar de una única paleta fija azul/marina.
+
+- Modos oscuro y claro.
+- Paletas de acento listas para usar, incluidas opciones esmeralda y similares a VS Code.
+- Colores de acento personalizados para temas oscuros y claros.
+- Estilizado basado en tokens para anillos de enfoque, controles activos, botones, navegación y
+ paneles.
+
+### MCP y complementos
+
+Pixcode incluye puntos de extensión para flujos de trabajo locales:
+
+- Gestión de servidores MCP para proveedores compatibles.
+- Paneles de autenticación, MCP y sesiones específicos del proveedor.
+- Carga de complementos con pestañas de frontend opcionales y servicios de backend.
+- Configuración local para claves API, URL base, catálogos de modelos y estado de instalación
+ del proveedor.
+
+## Instalación
+
+### Requisitos
+
+- Node.js 22 o posterior.
+- Los CLIs de los proveedores que deseas utilizar, instalados y autenticados por separado cuando
+ sea necesario.
+
+### Ejecutar con npx
+
+```bash
+npx @pixelbyte-software/pixcode
+```
+
+Abrir:
+
+```text
+http://localhost:3001
+```
+
+### Instalación global
+
+```bash
+npm install -g @pixelbyte-software/pixcode
+pixcode
+```
+
+### Instaladores de escritorio
+
+Descarga las compilaciones de escritorio desde los Lanzamientos de GitHub:
+
+- Windows: `.exe`
+- macOS: `.dmg`
+- Linux: AppImage o paquete de activos, dependiendo del lanzamiento
+
+Lanzamientos: