Documentación de Devia Desktop

¿Qué es Devia Desktop?

Devia Desktop es una aplicación de escritorio para desarrollar software con agentes de IA. Es una interfaz amigable y unificada sobre múltiples herramientas CLI agénticas (Claude Code, Codex, Gemini CLI y más) que convierte el trabajo con agentes en terminal en una experiencia visual, organizada y multiproyecto.

Es FreeWare: gratis con el 100% de las funcionalidades, disponible para Windows, macOS y Linux. Todo funciona en local, sobre tus proyectos y tus CLIs; no necesita cuenta ni conexión a ningún servicio.

Instalación

Windows

1. Descarga el instalador .exe desde la página de descargas.
2. Ejecútalo y elige el directorio de instalación (instalación por usuario, sin permisos de administrador).
3. Si SmartScreen muestra un aviso, pulsa «Más información → Ejecutar de todas formas».

macOS

1. Descarga el .dmg de tu arquitectura (Apple Silicon o Intel).
2. Ábrelo y arrastra Devia a la carpeta Aplicaciones.
3. La app está firmada y notarizada por Apple: se abre sin pasos adicionales.

Linux

1. AppImage: descárgalo, dale permisos con chmod +x Devia-*.AppImage y ejecútalo.
2. Debian/Ubuntu: instala el paquete con sudo dpkg -i devia_*_amd64.deb.

Primeros pasos

1. Elige tu workspace. La primera vez que abres Devia, un modal te pide la carpeta raíz donde viven tus proyectos (por ejemplo ~/repos). Devia lista los proyectos que contiene y detecta su tecnología.
2. Conecta un agente. Devia detecta los CLIs agénticos instalados en tu máquina y te deja elegir el agente activo en Configuración. Cada proyecto queda configurado para que el agente funcione sin ajustes manuales.
3. Conversa. Abre un proyecto y escribe tu primera instrucción en el compositor. Elige el modo de ejecución — plan (solo planifica), apply (aplica con permisos) o apply-yolo (sin confirmaciones) — según cuánta autonomía quieras dar.
4. Revisa. Cada respuesta llega en streaming con markdown, las llamadas a herramientas se despliegan en tarjetas y los cambios del agente se ven como diffs en línea.

Agentes compatibles

Devia funciona con los siguientes CLIs de codificación, y puedes cambiar de uno a otro sin salir de la app:

Al continuar una sesión con un agente distinto del que la inició, Devia hace un traspaso de contexto automático: inyecta un resumen del trabajo (objetivo, ficheros tocados y últimos intercambios) en el primer turno del nuevo agente y deja un divisor en el chat.

Funcionalidades

Multiproyecto y sesiones

• Listado, creación (vacío o desde plantilla) y clonado de proyectos; anclado de favoritos en la barra lateral.
• Historial de sesiones por proyecto que sobrevive reinicios; continúa o reinicia una sesión con un clic.
• Cola de instrucciones: encola prompts mientras el agente está ocupado, reordena con arrastrar y soltar, pausa y reanuda.

Vista dividida multi-sesión

• Hasta 4 paneles (2×2) en la misma ventana, cada uno con su propia sesión y su agente trabajando en paralelo.
• Cada panel adicional trabaja aislado en su propio git worktree (rama nueva desde la rama principal) para que dos agentes nunca pisen los mismos ficheros.
• El split y sus worktrees sobreviven al reinicio de la app, recuperando los ficheros de cada sesión.

Kanban con SDD integrado

• Tablero Kanban por proyecto con specs, tareas y dependencias.
• El propio agente lee y actualiza el tablero vía MCP (devia-kanban): flujo spec-driven development de principio a fin.
• El estado vive fuera del repositorio, en la carpeta de datos de Devia.

Memoria persistente

• Memoria propia entre sesiones (devia-memory) con ámbito personal y por proyecto.
• El agente la consulta y la alimenta automáticamente: decisiones, bugs resueltos y descubrimientos quedan registrados.
• Panel de gestión en Configuración: busca, fija, olvida o limpia observaciones.

Git integrado

• Estado del repositorio en vivo en la barra lateral.
• Visor de cambios con comentarios en línea: anota líneas del diff y envíalas al agente como petición de revisión.
• Soporte de worktrees y snapshots con rollback antes de operaciones destructivas.

Servidores MCP, skills y prompts

• Gestor de servidores Model Context Protocol: instala, activa, prueba y comparte servidores entre agentes; Devia inyecta la configuración en el formato nativo de cada CLI.
• Descubre e instala skills locales o desde GitHub.
• Prompt packs: paquetes de prompt de sistema por proyecto.
• Gestor de sub-agentes multi-CLI reutilizables entre proyectos.

Control remoto por Telegram

• Lanza ejecuciones, consulta el estado (rama, contexto usado, coste) y conversa con el agente desde Telegram.
• Espejo opcional de la conversación de escritorio y envío de adjuntos (fotos, documentos) al agente.

Terminal, voz y más

• Terminal integrado por proyecto con PTY real, y apertura del proyecto en tu IDE favorito.
• Orquestación de Docker Compose: deploy, down y logs por proyecto.
• Transcripción de voz local con Whisper — el audio nunca sale de tu máquina.
• Adjuntos de imagen con arrastrar y soltar para modelos multimodales.
• Navegador de archivos del proyecto en el raíl derecho y archivo de ficheros generados por el agente (outbox).
• Registro de auditoría de cada tool-call con rotación y retención de 30 días.
• 11 idiomas (es, en, ca, fr, de, it, pt, ru, zh, hi, ar), 8 paletas de acento Material 3 y tamaño de fuente ajustable.

Configuración y datos

Toda la información de Devia vive en tu disco, bajo ~/.devia-app/ (en Windows, C:\Users\<tu-usuario>\.devia-app\):

Para hacer copia de seguridad de tu Devia basta con copiar esa carpeta. Borrarla devuelve la app a su estado inicial.

Actualizaciones

Las versiones publicadas se anuncian en el manifiesto público de este sitio: updates/latest.json. Contiene la última versión disponible, la fecha de publicación, las notas y los enlaces de descarga por plataforma.

Devia Desktop consulta ese manifiesto para avisarte de que hay una versión nueva. También puedes comprobarlo a mano o desde tus scripts:

curl -s https://dherrero.github.io/devia/updates/latest.json | jq .version

Preguntas frecuentes

¿Devia es gratis?

Sí. Devia Desktop es FreeWare con el 100% de las funcionalidades, en todas las plataformas.

¿Necesito cuenta o conexión a algún servicio de Devia?

No. Devia Desktop funciona completamente en local. Los únicos servicios externos que se usan son los de los propios agentes CLI que tú tengas configurados.

¿Devia incluye los agentes de IA?

No: Devia es la interfaz que los dirige. Necesitas tener instalado al menos un CLI agéntico (Claude Code, Codex, Gemini CLI, OpenCode…) con sus credenciales. Devia los detecta y se encarga del resto.

¿Mis datos salen de mi máquina?

No. Sesiones, memoria, kanban y configuración viven en ~/.devia-app/. La transcripción de voz con Whisper también se ejecuta en local. Lo único que viaja es lo que el agente CLI que uses envíe a su propio proveedor.

¿En qué idiomas está disponible?

Español, inglés, valenciano, francés, alemán, italiano, portugués, ruso, chino, hindi y árabe.

¿Cómo reporto un problema?

Abre una incidencia en el repositorio de GitHub de Devia con los pasos para reproducirlo y tu plataforma (Windows/macOS/Linux).