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

  1. Lade den Installer .exe von der Download-Seite herunter.
  2. Führe ihn aus und wähle das Installationsverzeichnis (Benutzerinstallation, ohne Administratorrechte).
  3. Wenn SmartScreen eine Warnung anzeigt, klicke auf „Weitere Informationen → Trotzdem ausführen“.

macOS

  1. Lade das .dmg für deine Architektur (Apple Silicon oder Intel) herunter.
  2. Öffne es und ziehe Devia in den Ordner Programme.
  3. Die App ist von Apple signiert und notarisiert: sie öffnet sich ohne zusätzliche Schritte.

Linux

  1. AppImage: herunterladen, Ausführungsrechte mit chmod +x Devia-*.AppImage setzen und starten.
  2. Debian/Ubuntu: Paket mit sudo dpkg -i devia_*_amd64.deb installieren.

Erste Schritte

  1. 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.
  2. 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.
  3. 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.
  4. Ü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:

AgentHinweise
Claude CodeVollständige Integration, einschließlich MCP-Server pro Ausführung
OpenAI CodexJSON-Event-Streaming
Gemini CLIJSON-Event-Streaming
OpenCodeJSON-Event-Streaming
Cursor AgentJSON-Event-Streaming
GitHub Copilot CLIJSON-Event-Streaming
Qwen · DeepSeek · QoderNur-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\):

PfadInhalt
devia-app.config.jsonKonfiguration: Workspace, aktiver Agent, Theme, Sprache …
sessions/<proyecto>/Chat-Verlauf pro Projekt
projects/<clave>/kanban.jsonKanban-Board des Projekts
memory-global.json · projects/<clave>/memory.jsonPersistentes Gedächtnis (persönlich · pro Projekt)
mcp-servers.jsonKonfigurierte MCP-Server
outbox-archive/Vom Agenten generierte Dateien
attachments/Im Eingabefeld angehängte Bilder
audit.logTool-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).