Dokumentation zu Devia Desktop
Was ist Devia Desktop?
Devia Desktop ist eine Desktop-App zur Softwareentwicklung mit KI-Agenten. Sie bietet eine einheitliche, benutzerfreundliche Oberfläche für mehrere agentische CLI-Tools (Claude Code, Codex, Gemini CLI und mehr) und verwandelt die Arbeit mit Terminal-Agenten in ein visuelles, strukturiertes und multiprojektfähiges Erlebnis.
Es ist FreeWare: kostenlos mit 100% der Funktionen, verfügbar für Windows, macOS und Linux. Alles läuft lokal, auf deinen Projekten und deinen CLIs — kein Konto und keine Verbindung zu einem externen Dienst erforderlich.
Installation
Windows
- Lade den Installer
.exevon der Download-Seite herunter. - Führe ihn aus und wähle das Installationsverzeichnis (Benutzerinstallation, ohne Administratorrechte).
- Wenn SmartScreen eine Warnung anzeigt, klicke auf „Weitere Informationen → Trotzdem ausführen“.
macOS
- Lade das
.dmgfür deine Architektur (Apple Silicon oder Intel) herunter. - Öffne es und ziehe Devia in den Ordner Programme.
- Die App ist von Apple signiert und notarisiert: sie öffnet sich ohne zusätzliche Schritte.
Linux
- AppImage: herunterladen, Ausführungsrechte mit
chmod +x Devia-*.AppImagesetzen und starten. - Debian/Ubuntu: Paket mit
sudo dpkg -i devia_*_amd64.debinstallieren.
Erste Schritte
- Workspace auswählen. Beim ersten Start fragt Devia in einem Dialog nach dem Stammordner deiner Projekte (z. B.
~/repos). Devia listet die enthaltenen Projekte auf und erkennt deren Technologie. - Agenten verbinden. Devia erkennt die auf deiner Maschine installierten agentischen CLIs und lässt dich den aktiven Agenten in den Einstellungen auswählen. Jedes Projekt wird so konfiguriert, dass der Agent ohne manuelle Anpassungen funktioniert.
- Loslegen. Öffne ein Projekt und schreibe deine erste Anweisung in das Eingabefeld. Wähle den Ausführungsmodus — plan (nur planen), apply (mit Berechtigungen anwenden) oder apply-yolo (ohne Bestätigungen) — je nachdem, wie viel Autonomie du dem Agenten geben möchtest.
- Überprüfen. Jede Antwort kommt per Streaming mit markdown; Tool-Aufrufe klappen als Karten auf und Änderungen des Agenten erscheinen als Inline-Diffs.
Unterstützte Agenten
Devia funktioniert mit den folgenden Coding-CLIs, zwischen denen du wechseln kannst, ohne die App zu verlassen:
| Agent | Hinweise |
|---|---|
| Claude Code | Vollständige Integration, einschließlich MCP-Server pro Ausführung |
| OpenAI Codex | JSON-Event-Streaming |
| Gemini CLI | JSON-Event-Streaming |
| OpenCode | JSON-Event-Streaming |
| Cursor Agent | JSON-Event-Streaming |
| GitHub Copilot CLI | JSON-Event-Streaming |
| Qwen · DeepSeek · Qoder | Nur-Text-Ausgabe |
Wenn eine Sitzung mit einem anderen als dem ursprünglichen Agenten fortgesetzt wird, führt Devia einen automatischen Kontext-Handoff durch: Es injiziert eine Zusammenfassung der bisherigen Arbeit (Ziel, bearbeitete Dateien und letzte Austausche) in den ersten Zug des neuen Agenten und setzt einen Trenner im Chat.
Funktionen
Multiprojekt und Sitzungen
- Auflistung, Erstellung (leer oder aus Vorlage) und Klonen von Projekten; Favoriten in der Seitenleiste anheften.
- Projekteigener Sitzungsverlauf, der Neustarts übersteht; Sitzung mit einem Klick fortsetzen oder neu starten.
- Instruktionswarteschlange: Prompts einstellen, während der Agent beschäftigt ist, per Drag-and-drop neu anordnen, pausieren und fortsetzen.
Geteilte Ansicht mit mehreren Sitzungen
- Bis zu 4 Panels (2×2) im selben Fenster, jedes mit eigener Sitzung und eigenem parallel arbeitenden Agenten.
- Jedes weitere Panel arbeitet isoliert in seinem eigenen git worktree (neuer Branch vom Hauptbranch), damit zwei Agenten nie dieselben Dateien bearbeiten.
- Der Split und seine Worktrees überleben den App-Neustart und stellen die Dateien jeder Sitzung wieder her.
Kanban mit integriertem SDD
- Projektbezogenes Kanban-Board mit Specs, Aufgaben und Abhängigkeiten.
- Der Agent selbst liest und aktualisiert das Board per MCP (
devia-kanban): spec-driven development von Anfang bis Ende. - Der Status liegt außerhalb des Repositories, im Datenordner von Devia.
Persistentes Gedächtnis
- Eigenes sitzungsübergreifendes Gedächtnis (
devia-memory) mit persönlichem und projektbezogenem Scope. - Der Agent fragt es automatisch ab und befüllt es: Entscheidungen, behobene Bugs und Erkenntnisse werden festgehalten.
- Verwaltungspanel in den Einstellungen: Beobachtungen suchen, anheften, vergessen oder löschen.
Integriertes Git
- Live-Repository-Status in der Seitenleiste.
- Änderungsviewer mit Inline-Kommentaren: Zeilen des Diffs annotieren und als Review-Anfrage an den Agenten senden.
- Unterstützung von Worktrees und Snapshots mit Rollback vor destruktiven Operationen.
MCP-Server, Skills und Prompts
- Manager für Model Context Protocol-Server: Server zwischen Agenten installieren, aktivieren, testen und teilen; Devia injiziert die Konfiguration im nativen Format des jeweiligen CLIs.
- Lokale Skills oder Skills von GitHub entdecken und installieren.
- Prompt Packs: projektspezifische System-Prompt-Pakete.
- Manager für wiederverwendbare Multi-CLI-Sub-Agenten über Projekte hinweg.
Fernsteuerung per Telegram
- Ausführungen starten, Status abfragen (Branch, verwendeter Kontext, Kosten) und per Telegram mit dem Agenten chatten.
- Optionale Spiegelung des Desktop-Gesprächs und Versand von Anhängen (Fotos, Dokumente) an den Agenten.
Terminal, Sprache und mehr
- Projektintegriertes Terminal mit echtem PTY und Öffnen des Projekts in deiner bevorzugten IDE.
- Docker Compose-Orchestrierung: Deploy, Down und Logs pro Projekt.
- Lokale Sprachtranskription mit Whisper — das Audio verlässt niemals dein Gerät.
- Bild-Anhänge per Drag-and-drop für multimodale Modelle.
- Projektdatei-Browser in der rechten Leiste und Archiv der vom Agenten generierten Dateien (Outbox).
- Audit-Log jedes Tool-Calls mit Rotation und 30-tägiger Aufbewahrung.
- 11 Sprachen (es, en, ca, fr, de, it, pt, ru, zh, hi, ar), 8 Material 3-Akzentpaletten und einstellbare Schriftgröße.
Konfiguration und Daten
Alle Daten von Devia liegen auf deiner Festplatte, unter ~/.devia-app/ (unter Windows: C:\Users\<tu-usuario>\.devia-app\):
| Pfad | Inhalt |
|---|---|
devia-app.config.json | Konfiguration: Workspace, aktiver Agent, Theme, Sprache … |
sessions/<proyecto>/ | Chat-Verlauf pro Projekt |
projects/<clave>/kanban.json | Kanban-Board des Projekts |
memory-global.json · projects/<clave>/memory.json | Persistentes Gedächtnis (persönlich · pro Projekt) |
mcp-servers.json | Konfigurierte MCP-Server |
outbox-archive/ | Vom Agenten generierte Dateien |
attachments/ | Im Eingabefeld angehängte Bilder |
audit.log | Tool-Call-Protokoll (JSONL mit Rotation) |
Um ein Backup deiner Devia-Daten zu erstellen, kopiere einfach diesen Ordner. Das Löschen setzt die App auf den Ausgangszustand zurück.
Updates
Veröffentlichte Versionen werden im öffentlichen Manifest dieser Website angekündigt: updates/latest.json. Es enthält die neueste verfügbare Version, das Veröffentlichungsdatum, die Versionshinweise und die Downloadlinks pro Plattform.
Devia Desktop ruft dieses Manifest ab, um dich auf eine neue Version hinzuweisen. Du kannst es auch manuell oder über eigene Skripte prüfen:
curl -s https://dherrero.github.io/devia/updates/latest.json | jq .version
Häufige Fragen
Ist Devia kostenlos?
Ja. Devia Desktop ist FreeWare mit 100% der Funktionen, auf allen Plattformen.
Benötige ich ein Konto oder eine Verbindung zu einem Devia-Dienst?
Nein. Devia Desktop funktioniert vollständig lokal. Die einzigen externen Dienste, die genutzt werden, sind die der CLI-Agenten, die du selbst konfiguriert hast.
Enthält Devia die KI-Agenten?
Nein: Devia ist die Oberfläche, die sie steuert. Du benötigst mindestens einen installierten agentischen CLI (Claude Code, Codex, Gemini CLI, OpenCode …) mit deinen Zugangsdaten. Devia erkennt sie und kümmert sich um den Rest.
Verlassen meine Daten mein Gerät?
Nein. Sitzungen, Gedächtnis, Kanban und Konfiguration liegen unter ~/.devia-app/. Die Sprachtranskription mit Whisper läuft ebenfalls lokal. Das Einzige, was übertragen wird, ist das, was der von dir verwendete CLI-Agent an seinen eigenen Anbieter sendet.
In welchen Sprachen ist Devia verfügbar?
Spanisch, Englisch, Valencianisch, Französisch, Deutsch, Italienisch, Portugiesisch, Russisch, Chinesisch, Hindi und Arabisch.
Wie melde ich ein Problem?
Öffne ein Issue im GitHub-Repository von Devia mit den Schritten zur Reproduktion und deiner Plattform (Windows/macOS/Linux).