Documentació de Devia Desktop

Què és Devia Desktop?

Devia Desktop és una aplicació d'escriptori per a desenvolupar programari amb agents d'IA. És una interfície amigable i unificada sobre múltiples ferramentes CLI agèntiques (Claude Code, Codex, Gemini CLI i més) que convertix el treball amb agents en terminal en una experiència visual, organitzada i multiprojecte.

És FreeWare: gratis amb el 100% de les funcionalitats, disponible per a Windows, macOS i Linux. Tot funciona en local, sobre els teus projectes i els teus CLIs; no necessita compte ni connexió a cap servici.

Instal·lació

Windows

Descarrega l'instal·lador .exe des de la pàgina de descàrregues.
Executa'l i tria el directori d'instal·lació (instal·lació per usuari, sense permisos d'administrador).
Si SmartScreen mostra un avís, prem «Més informació → Executar de totes formes».

macOS

Descarrega el .dmg de la teua arquitectura (Apple Silicon o Intel).
Obri'l i arrossega Devia a la carpeta Aplicacions.
L'app està signada i notaritzada per Apple: s'obri sense passos addicionals.

Linux

AppImage: descarrega'l, dona-li permisos amb chmod +x Devia-*.AppImage i executa'l.
Debian/Ubuntu: instal·la el paquet amb sudo dpkg -i devia_*_amd64.deb.

Primers passos

Tria el teu workspace. La primera vegada que obris Devia, un modal et demana la carpeta arrel on viuen els teus projectes (per exemple ~/repos). Devia llista els projectes que conté i detecta la seua tecnologia.
Connecta un agent. Devia detecta els CLIs agèntics instal·lats en la teua màquina i et deixa triar l'agent actiu en Configuració. Cada projecte queda configurat perquè l'agent funcione sense ajustos manuals.
Conversa. Obri un projecte i escriu la teua primera instrucció en el compositor. Tria el mode d'execució — plan (només planifica), apply (aplica amb permisos) o apply-yolo (sense confirmacions) — segons quanta autonomia vulgues donar.
Revisa. Cada resposta arriba en streaming amb markdown, les crides a ferramentes es despleguen en targetes i els canvis de l'agent es veuen com a diffs en línia.

Agents compatibles

Devia funciona amb els següents CLIs de codificació, i pots canviar d'un a l'altre sense eixir de l'app:

Agent	Notes
Claude Code	Integració completa, inclosos servidors MCP per execució
OpenAI Codex	Streaming d'events JSON
Gemini CLI	Streaming d'events JSON
OpenCode	Streaming d'events JSON
Cursor Agent	Streaming d'events JSON
GitHub Copilot CLI	Streaming d'events JSON
Qwen · DeepSeek · Qoder	Eixida en text pla

En continuar una sessió amb un agent distint del que la va iniciar, Devia fa un traspàs de context automàtic: injecta un resum del treball (objectiu, fitxers tocats i últims intercanvis) en el primer torn del nou agent i deixa un divisor en el xat.

Funcionalitats

Multiprojecte i sessions

Llistat, creació (buit o des de plantilla) i clonació de projectes; ancorat de favorits en la barra lateral.
Historial de sessions per projecte que sobreviu als reinicis; continua o reinicia una sessió amb un clic.
Cua d'instruccions: encua prompts mentre l'agent està ocupat, reordena amb arrossegar i soltar, pausa i reprén.

Vista dividida multi-sessió

Fins a 4 panells (2×2) en la mateixa finestra, cadascun amb la seua pròpia sessió i el seu agent treballant en paral·lel.
Cada panell addicional treballa aïllat en el seu propi git worktree (branca nova des de la branca principal) perquè dos agents mai trepitgen els mateixos fitxers.
El split i els seus worktrees sobreviuen al reinici de l'app, recuperant els fitxers de cada sessió.

Kanban amb SDD integrat

Tauler Kanban per projecte amb specs, tasques i dependències.
El propi agent llig i actualitza el tauler via MCP (devia-kanban): flux spec-driven development de principi a fi.
L'estat viu fora del repositori, en la carpeta de dades de Devia.

Memòria persistent

Memòria pròpia entre sessions (devia-memory) amb àmbit personal i per projecte.
L'agent la consulta i l'alimenta automàticament: decisions, bugs resolts i descobriments queden registrats.
Panell de gestió en Configuració: busca, fixa, oblida o neteja observacions.

Git integrat

Estat del repositori en viu en la barra lateral.
Visor de canvis amb comentaris en línia: anota línies del diff i envia-les a l'agent com a petició de revisió.
Suport de worktrees i snapshots amb rollback abans d'operacions destructives.

Servidors MCP, skills i prompts

Gestor de servidors Model Context Protocol: instal·la, activa, prova i compartix servidors entre agents; Devia injecta la configuració en el format natiu de cada CLI.
Descobrix i instal·la skills locals o des de GitHub.
Prompt packs: paquets de prompt de sistema per projecte.
Gestor de sub-agents multi-CLI reutilitzables entre projectes.

Control remot per Telegram

Llança execucions, consulta l'estat (branca, context usat, cost) i conversa amb l'agent des de Telegram.
Mirall opcional de la conversació d'escriptori i enviament d'adjunts (fotos, documents) a l'agent.

Terminal, veu i més

Terminal integrat per projecte amb PTY real, i obertura del projecte en el teu IDE favorit.
Orquestració de Docker Compose: deploy, down i logs per projecte.
Transcripció de veu local amb Whisper — l'àudio mai ix de la teua màquina.
Adjunts d'imatge amb arrossegar i soltar per a models multimodals.
Navegador de fitxers del projecte en el rail dret i arxiu de fitxers generats per l'agent (outbox).
Registre d'auditoria de cada tool-call amb rotació i retenció de 30 dies.
11 idiomes (es, en, ca, fr, de, it, pt, ru, zh, hi, ar), 8 paletes d'accent Material 3 i mida de font ajustable.

Configuració i dades

Tota la informació de Devia viu en el teu disc, baix ~/.devia-app/ (en Windows, C:\Users\<tu-usuario>\.devia-app\):

Ruta	Contingut
`devia-app.config.json`	Configuració: workspace, agent actiu, tema, idioma…
`sessions/<proyecto>/`	Historial de xat per projecte
`projects/<clave>/kanban.json`	Tauler Kanban del projecte
`memory-global.json` · `projects/<clave>/memory.json`	Memòria persistent (personal · per projecte)
`mcp-servers.json`	Servidors MCP configurats
`outbox-archive/`	Fitxers generats per l'agent
`attachments/`	Imatges adjuntades en l'input
`audit.log`	Registre de tool-calls (JSONL amb rotació)

Per a fer còpia de seguretat de Devia n'hi ha prou amb copiar esta carpeta. Esborrar-la torna l'app al seu estat inicial.

Actualitzacions

Les versions publicades s'anuncien en el manifest públic d'este lloc: updates/latest.json. Conté l'última versió disponible, la data de publicació, les notes i els enllaços de descàrrega per plataforma.

Devia Desktop consulta este manifest per a avisar-te que hi ha una versió nova. També pots comprovar-ho a mà o des dels teus scripts:

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

Preguntes freqüents

Devia és gratis?

Sí. Devia Desktop és FreeWare amb el 100% de les funcionalitats, en totes les plataformes.

Necessite compte o connexió a algun servici de Devia?

No. Devia Desktop funciona completament en local. Els únics servicis externs que s'usen són els dels propis agents CLI que tu tingues configurats.

Devia inclou els agents d'IA?

No: Devia és la interfície que els dirigix. Necessites tindre instal·lat almenys un CLI agèntic (Claude Code, Codex, Gemini CLI, OpenCode…) amb les seues credencials. Devia els detecta i s'encarrega de la resta.

Les meues dades ixen de la meua màquina?

No. Sessions, memòria, kanban i configuració viuen en ~/.devia-app/. La transcripció de veu amb Whisper també s'executa en local. L'únic que viaja és el que l'agent CLI que uses envia al seu propi proveïdor.

En quins idiomes està disponible?

Espanyol, anglés, valencià, francés, alemany, italià, portugués, rus, xinés, hindi i àrab.

Com reporto un problema?

Obri una incidència en el repositori de GitHub de Devia amb els passos per a reproduir-lo i la teua plataforma (Windows/macOS/Linux).