Documentazione di Devia Desktop

Che cos'è Devia Desktop?

Devia Desktop è un'applicazione desktop per sviluppare software con agenti di IA. È un'interfaccia unificata e intuitiva per molteplici strumenti CLI agentici (Claude Code, Codex, Gemini CLI e altri) che trasforma il lavoro con gli agenti da terminale in un'esperienza visiva, organizzata e multi-progetto.

È FreeWare: gratuito con il 100% delle funzionalità, disponibile per Windows, macOS e Linux. Tutto funziona in locale, sui tuoi progetti e i tuoi CLI; non richiede account né connessione ad alcun servizio.

Installazione

Windows

1. Scarica il programma di installazione .exe dalla pagina dei download.
2. Avvialo e scegli la directory di installazione (installazione per utente, senza privilegi di amministratore).
3. Se SmartScreen mostra un avviso, clicca su «Ulteriori informazioni → Esegui comunque».

macOS

1. Scarica il file .dmg per la tua architettura (Apple Silicon o Intel).
2. Aprilo e trascina Devia nella cartella Applicazioni.
3. L'app è firmata e notarizzata da Apple: si apre senza passaggi aggiuntivi.

Linux

1. AppImage: scaricalo, assegna i permessi con chmod +x Devia-*.AppImage e avvialo.
2. Debian/Ubuntu: installa il pacchetto con sudo dpkg -i devia_*_amd64.deb.

Primi passi

1. Scegli il tuo workspace. La prima volta che apri Devia, una finestra modale ti chiede la cartella radice in cui risiedono i tuoi progetti (ad esempio ~/repos). Devia elenca i progetti che contiene e ne rileva la tecnologia.
2. Connetti un agente. Devia rileva i CLI agentici installati sulla tua macchina e ti permette di scegliere l'agente attivo nelle Impostazioni. Ogni progetto viene configurato in modo che l'agente funzioni senza interventi manuali.
3. Conversa. Apri un progetto e scrivi la tua prima istruzione nel compositore. Scegli la modalità di esecuzione — plan (solo pianifica), apply (applica con permessi) o apply-yolo (senza conferme) — in base a quanta autonomia vuoi concedere.
4. Rivedi. Ogni risposta arriva in streaming con markdown, le chiamate agli strumenti si espandono in schede e le modifiche dell'agente appaiono come diff inline.

Agenti compatibili

Devia funziona con i seguenti CLI di codifica, e puoi passare dall'uno all'altro senza uscire dall'app:

Quando si riprende una sessione con un agente diverso da quello che l'ha avviata, Devia esegue un passaggio di contesto automatico: inietta un riepilogo del lavoro svolto (obiettivo, file modificati e ultimi scambi) nel primo turno del nuovo agente e aggiunge un divisore nella chat.

Funzionalità

Multi-progetto e sessioni

• Elenco, creazione (vuoto o da template) e clonazione di progetti; aggiunta ai preferiti nella barra laterale.
• Cronologia delle sessioni per progetto che sopravvive ai riavvii; riprendi o riavvia una sessione con un clic.
• Coda di istruzioni: metti in coda prompt mentre l'agente è occupato, riordina con il trascinamento, metti in pausa e riprendi.

Vista divisa multi-sessione

• Fino a 4 pannelli (2×2) nella stessa finestra, ciascuno con la propria sessione e il proprio agente che lavorano in parallelo.
• Ogni pannello aggiuntivo opera in isolamento nel proprio git worktree (nuovo branch dal branch principale) in modo che due agenti non modifichino mai gli stessi file.
• La vista divisa e i suoi worktree sopravvivono al riavvio dell'app, ripristinando i file di ogni sessione.

Kanban con SDD integrato

• Bacheca Kanban per progetto con spec, task e dipendenze.
• L'agente stesso legge e aggiorna la bacheca tramite MCP (devia-kanban): flusso spec-driven development dall'inizio alla fine.
• Lo stato risiede fuori dal repository, nella cartella dati di Devia.

Memoria persistente

• Memoria propria tra le sessioni (devia-memory) con ambito personale e per progetto.
• L'agente la consulta e la alimenta automaticamente: decisioni, bug risolti e scoperte vengono registrati.
• Pannello di gestione nelle Impostazioni: cerca, fissa, elimina o cancella le osservazioni.

Git integrato

• Stato del repository in tempo reale nella barra laterale.
• Visualizzatore di modifiche con commenti inline: annota le righe del diff e inviale all'agente come richiesta di revisione.
• Supporto ai worktree e snapshot con rollback prima di operazioni distruttive.

Server MCP, skills e prompt

• Gestore di server Model Context Protocol: installa, attiva, testa e condividi server tra gli agenti; Devia inietta la configurazione nel formato nativo di ogni CLI.
• Scopri e installa skills locali o da GitHub.
• Prompt packs: pacchetti di prompt di sistema per progetto.
• Gestore di sub-agenti multi-CLI riutilizzabili tra i progetti.

Controllo remoto via Telegram

• Avvia esecuzioni, controlla lo stato (branch, contesto utilizzato, costo) e conversa con l'agente da Telegram.
• Mirroring opzionale della conversazione desktop e invio di allegati (foto, documenti) all'agente.

Terminale, voce e altro

• Terminale integrato per progetto con PTY reale, e apertura del progetto nel tuo IDE preferito.
• Orchestrazione di Docker Compose: deploy, down e log per progetto.
• Trascrizione vocale locale con Whisper — l'audio non lascia mai la tua macchina.
• Allegati di immagini con trascinamento per i modelli multimodali.
• Browser dei file del progetto nel pannello destro e archivio dei file generati dall'agente (outbox).
• Registro di audit di ogni tool-call con rotazione e conservazione per 30 giorni.
• 11 lingue (es, en, ca, fr, de, it, pt, ru, zh, hi, ar), 8 palette di accento Material 3 e dimensione del testo regolabile.

Configurazione e dati

Tutte le informazioni di Devia risiedono sul tuo disco, in ~/.devia-app/ (su Windows, C:\Users\<tu-usuario>\.devia-app\):

Per eseguire il backup di Devia è sufficiente copiare quella cartella. Eliminarla riporta l'app allo stato iniziale.

Aggiornamenti

Le versioni pubblicate vengono annunciate nel manifesto pubblico di questo sito: updates/latest.json. Contiene l'ultima versione disponibile, la data di pubblicazione, le note di rilascio e i link di download per piattaforma.

Devia Desktop consulta quel manifesto per avvisarti della disponibilità di una nuova versione. Puoi anche verificarlo manualmente o dai tuoi script:

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

Domande frequenti

Devia è gratuito?

Sì. Devia Desktop è FreeWare con il 100% delle funzionalità, su tutte le piattaforme.

Ho bisogno di un account o di una connessione a un servizio Devia?

No. Devia Desktop funziona completamente in locale. Gli unici servizi esterni utilizzati sono quelli dei CLI agentici che hai configurato.

Devia include gli agenti di IA?

No: Devia è l'interfaccia che li orchestra. Devi avere installato almeno un CLI agentico (Claude Code, Codex, Gemini CLI, OpenCode…) con le relative credenziali. Devia li rileva e si occupa del resto.

I miei dati lasciano la mia macchina?

No. Sessioni, memoria, kanban e configurazione risiedono in ~/.devia-app/. La trascrizione vocale con Whisper viene eseguita anch'essa in locale. L'unica cosa che viaggia è ciò che il CLI agentico che utilizzi invia al proprio provider.

In quali lingue è disponibile?

Spagnolo, inglese, valenziano, francese, tedesco, italiano, portoghese, russo, cinese, hindi e arabo.

Come segnalo un problema?

Apri una segnalazione nel repository GitHub di Devia con i passaggi per riprodurlo e la tua piattaforma (Windows/macOS/Linux).