claude-desktop/ROADMAP.md

# Claude Desktop — Roadmap

Stand: 28.04.2026

---

## Ziel

Claude Desktop soll **schneller und maechtiger** sein als Codium + Claude Code Extension. Kein Feature-Bloat — nur das was echten Geschwindigkeits- und Produktivitaetsvorteil bringt.

---

## Abgeschlossen (v0.1.0 — 14.04.2026)

Alles aus Phase 1-16 ist implementiert und funktionsfaehig:

- Tauri 2.0 + SvelteKit 5 + Claude Agent SDK
- 4-Panel Layout mit 24 UI-Komponenten
- Claude Bridge (Node.js, stdio JSON-Lines)
- Guard-Rails System (Safe/Moderate/Critical/Blocked)
- SQLite Persistierung + Session-Management
- Claude-DB Integration (Wissensbasis durchsuchen/speichern)
- 3-Schichten Context-Management (Sticky/Projekt/Hints)
- Sprach-Interface (Whisper STT + OpenAI TTS)
- Multi-Agent-Modi (Solo/Handlanger/Experten/Auto)
- Hook-System (SessionStart, PreToolUse, PostToolUse)
- VSCodium-Extension (WebSocket Port 7890)
- Programm-Steuerung (D-Bus, Xvfb, Playwright-MCP)
- Praesentations-/Schulungsmodus
- System-Monitor + Performance-Metriken
- Subagent-Hierarchie mit Baumansicht
- Auto-Updater (Forgejo Package Registry)
- Slash-Command Autocomplete
- KB-Hints Injection + Proaktive Intelligenz
- Error-Pattern Auto-Detection (3x → KB-Eintrag)

---

## Phase 3: Performance (naechster Schritt)

**Ziel:** Erste Antwort in < 1s, Bridge immer warm, kein Warten.

| Feature | Datei(en) | Status |
|---------|-----------|--------|
| ✅ KB-Cache (RAM) | `knowledge.rs` | 60s TTL, LRU, max 100 Entries |
| ✅ Bridge Warm-Start | `lib.rs`, `claude.rs` | Start bei App-Launch, kein Cold-Start |
| ✅ Lazy Panel-Load | `+page.svelte` | Dynamic Import mit Cache |
| ✅ Session-Resume Fix | `claude-bridge.js` | Stale ID → auto-Retry neue Session |
| ✅ Auto-Retry (Netzwerk) | `claude-bridge.js` | 3x Backoff bei Rate-Limit/5xx |
| ✅ Bridge Heartbeat | `claude-bridge.js` | 30s Pulse an Rust |
| ✅ FIFO Message Queue | `ChatPanel.svelte` | Mehrere Nachrichten queuen |
| ✅ Bridge-Daemon | `claude.rs`, `claude-bridge.js` | Bridge ueberlebt App-Neustart (--socket Flag) |
| ✅ Unix Socket IPC | `claude.rs`, `claude-bridge.js` | stdio → UDS (async, Reconnect, PID-Tracking) |

---

## Phase 4: Codium-Killer Features

**Ziel:** Dinge die Codium + Extension prinzipbedingt NICHT koennen.

| Feature | Datei(en) | Status |
|---------|-----------|--------|
| ✅ Projekt-Wechsel | `db.rs`, `SessionList.svelte` | Ein Klick wechselt Projekt (CWD, Context, KB-Filter) |
| ✅ MCP-Hub nativ | `claude.rs`, `claude-bridge.js` | MCP-Server aus .claude.json, UI-Verwaltung, Runtime-Injection |
| ✅ Guard-Rails UI | `guard.rs`, `GuardRailsPanel.svelte` | Live-Feed, Risiko-Statistik, Ein-Klick-Freigabe, 3 Tabs |
| ✅ Persistent Memory | `memory.rs`, `claude.rs` | Auto-Load Eintraege in Context, Cross-Session Gedaechtnis |
| ✅ Quick-Actions | `QuickActions.svelte`, `ChatPanel.svelte` | Ctrl+K Palette: Deploy, Build, Test, Commit, Git, Navigation |
| ✅ Voice-Conversation | `voice.rs`, `VoicePanel.svelte` | Lokales Whisper STT + Piper TTS, VAD, Gespraechsmodus |
| ✅ Settings-Panel | `SettingsPanel.svelte` | VS-Code-artiges Layout mit Suche, Kategorien, Commands, Hooks |
| ✅ Chat-Detach | `chat_window.rs`, `+page.svelte` | Chat in separates Fenster herausloesen/zurueckholen |
| ✅ Aktivitaets-Phasen | `events.ts`, `ChatPanel.svelte` | 4 Phasen: Denkt/Streamt/Tool/Subagent statt nur "Denkt nach" |

---

## Phase 5: Lokale KI + Offline

**Ziel:** Unabhaengig von Cloud fuer Routine-Tasks.

| Feature | Datei(en) | Status |
|---------|-----------|--------|
| ✅ Whisper.cpp lokal | `voice.rs` | whisper-cli STT, Thorsten-DE Modell, kein OpenAI noetig |
| ✅ Piper-TTS lokal | `voice.rs` | piper-tts mit thorsten_emotional (high), offline |
| ✅ Lokales Haiku-Equivalent | `claude-bridge.js`, `claude.rs` | Ollama-Integration, Auto-Detect, local-query Command |
| ✅ Offline-Queue | `session.rs` | SQLite-Queue, queue/flush/clear Commands, Auto-Retry |

---

## Phase 6: Desktop-Integration (Linux-Native)

**Ziel:** Claude steuert den Desktop wie ein zweiter User.

| Feature | Datei(en) | Beschreibung |
|---------|-----------|--------------|
| ✅ D-Bus Actions | `programs.rs`, `ProgramsPanel.svelte` | 10 Aktionen: Dolphin, Kate, Konsole, Firefox, Notify, Lock |
| ✅ Clipboard-Watch | `clipboard.rs` | Claude reagiert auf Clipboard-Inhalt (Code/URL/Fehler erkennen) |
| ✅ File-Drop | `ChatPanel.svelte` | Dateien auf Chat droppen → Claude analysiert/bearbeitet |
| ✅ Screenshot-Analyse | `programs.rs`, `ProgramsPanel.svelte` | Spectacle/Scrot Region-Capture, Vorschau, an Chat senden |
| ✅ Global Hotkey | `lib.rs` | Super+C oeffnet Claude-Eingabe von ueberall |

---

## Phase 7: VS Code Extension Features

**Ziel:** Die besten Features der Claude Code VS Code Extension uebernehmen — Accept/Reject, @-Mentions, Checkpoints.

| Feature | Datei(en) | Status |
|---------|-----------|--------|
| ✅ Accept/Reject DiffView | `DiffView.svelte`, `checkpoint.rs`, `db.rs` | Post-Execution Approval mit Revert, Kompakt-Ansicht, interaktive Buttons |
| ✅ Checkpoint/Rewind | `checkpoint.rs`, `db.rs`, `claude.rs`, `claude-bridge.js` | Automatische Snapshots bei Edit/Write, SQLite-basiert, Rewind auf beliebigen Punkt |
| ✅ @-Mentions | `FileMention.svelte`, `context.rs`, `ChatPanel.svelte` | Fuzzy-Autocomplete, Dateiinhalt-Injection, Zeilenbereiche (#5-10) |
| ✅ Bridge Pending-Queue | `claude-bridge.js` | Nachrichten waehrend laufender Verarbeitung puffern, Auto-Dispatch nach Turn |
| ✅ Tool-ID Sync | `events.ts`, `app.ts` | Backend-IDs korrekt durchreichen, Aktivitaets-Punkte Bug behoben |
| ✅ Session-Projekt-Sync | `SessionList.svelte` | Session-Klick aktiviert zugehoeriges Projekt automatisch |

---

## Phase 8: VS-Code-Look — Chatbereich-Redesign

**Ziel:** Chatbereich strukturell und visuell wie die offizielle Claude Code Extension fuer VS Code/Codium gestalten — linksbuendige Messages, Inline-Tool-Karten, VS-Code-Dark-Theme. ChatPanel.svelte (~2000 Z.) wird in fokussierte Teilkomponenten zerlegt.

| Feature | Datei(en) | Status |
|---------|-----------|--------|
| ✅ VS-Code-Theme-Variablen | `theme/vscode.css`, `+layout.svelte` | `--vscode-*` Custom Properties + Aliase fuer Altcode |
| ✅ Inline-Render via MessageList | `ChatPanel.svelte` | Messages-Bereich in `<MessageList />` ausgelagert; Logik bleibt im Container |
| ✅ Message.svelte | `Message.svelte` (NEU) | Avatar links, linksbuendig, Hover-Actions (Edit/Regenerate/Copy/Merken/Rewind) |
| ✅ MessageList.svelte | `MessageList.svelte` (NEU) | Smart-Sticky-Scroll, Back-to-Bottom-Button |
| ✅ Inline Tool-Cards | `ToolCallCard.svelte`, `ToolCardRead/Edit/Bash/Generic.svelte` (NEU) | Klappbare Karten in Assistant-Message; Edit zeigt Diff + Accept/Reject |
| ✅ Tool-Calls an Message binden | `events.ts`, `app.ts` | `Message.toolCalls?[]` ergaenzt, Tool-Events an letzte Assistant-Msg gebunden |
| ✅ ChatStatusBar | `ChatStatusBar.svelte` (NEU) | Token/Mode/Modell + Modus-Picker; Header bekommt Spark-Icon |
| ✅ Eigen-Features-Mapping | — | Mic, Modus-Indikator, Detach, „Das merken" funktionieren weiter |
| ✅ Activity-Panel parallel | `ActivityPanel.svelte` | unveraendert, dient als History-View neben den Inline-Karten |

---

## Phase 9: Komplettes UI-Redesign — Cursor/Zed-Niveau (aktuell)

**Ziel:** Schluss mit Emoji-Inflation, 4-Pane-Zerstueckelung und Schriftgroessen-Chaos. Verbindliches Design-System (Farben/Typo/Spacing/Radius), 2-spaltiges Layout (Sidebar + Hauptbereich mit Tabs), Werkzeug-Panels als Drawer von rechts statt zwei nebeneinander liegender Tab-Reihen.

| Feature | Datei(en) | Status |
|---------|-----------|--------|
| ✅ Design-System (Variablen) | `app.css` | 4 Graustufen, 1 Akzent (#007acc), 4 Status-Farben, 5 Schriftgroessen, 4-Punkt-Spacing, 2 Radius-Werte |
| ✅ vscode.css Aliase | `theme/vscode.css` | `--vscode-*` Variablen mappen auf Phase-9-Variablen |
| ✅ UI-Library | `src/lib/ui/` | Button, Card, Icon, Badge, StatusDot, Tooltip, Drawer, Tabs |
| ✅ Lucide Icons | — | `lucide-svelte` installiert, ersetzt Emojis im Chrome |
| ✅ StatusBar (22px) | `StatusBar.svelte` (NEU) | Token · Modell+Modus · Kosten · Phase, klickbarer Modus-Picker |
| ✅ Titlebar entruempelt | `+layout.svelte` | Logo + Stop + Schulungsmodus (Lucide) + Version, kein Status-Dot mehr |
| ✅ Sidebar (240px) | `Sidebar.svelte` (NEU) | Suche (Cmd+K), Sessions, Nav-Rail mit 4 Lucide-Icons (Activity/Database/Wrench/Settings) |
| ✅ ToolDrawer | `ToolDrawer.svelte` (NEU) | Rechts-Drawer (420px) mit internen Tabs fuer Activity/Memory/Tools/Settings, Esc-schliessbar |
| ✅ +page.svelte 2-spaltig | `+page.svelte` | 4-Pane-PaneForge-Layout aufgeloest, jetzt: Sidebar + ChatPanel (flex) + Drawer-Overlay |
| ✅ Hardgecodete Farben raus | 9 Komponenten | `#ef4444 #22c55e #eab308 #f59e0b #a855f7 #06b6d4 ...` durch `var(--status-*)` ersetzt |
| ✅ Status-Emojis durch StatusDot | `AgentView.svelte` | `🟢 🟡 ⚪ 🔴` durch `<StatusDot>` mit Pulse-Animation bei aktivem Agent |
| ✅ ChatPanel entkoppelt | `ChatPanel.svelte` | Header + ChatStatusBar entfernt (jetzt global) — kompakte Toolbar nur noch fuer Detach |
| ✅ Cmd+K global | `+page.svelte`, `QuickActions.svelte` | Globaler Listener oeffnet QuickActions; navigate-tab oeffnet Drawer-Sektion |
| ⏳ Komponenten-Pass (Emojis raus) | 13 Panels | Emojis in Tab-Labels und Action-Buttons noch sukzessive durch Lucide ersetzen |

---

## Phase 16: Schulungsmodus-Ausbau — Session-Replay

**Ziel:** Das Praesentations-Fenster wird vom Slide-Stream zum vollwertigen Session-Replay. Drei Spalten: Datei-Baum links (waechst mit den beruehrten Pfaden), Workspace in der Mitte (animierter Edit oder Diff-Viewer), Timeline rechts (klickbare Liste aller Tool-Aktionen). Live waehrend Claude arbeitet, retroaktiv fuer gespeicherte Sessions.

**Architektur-Entscheidung:** Bridge-passiv vor MCP-Tools. Die Bridge sieht ohnehin jeden Tool-Call — sie schreibt einfach mit. Claude muss nichts wissen oder steuern. MCP-Tools fuer gezielte Erklaerung sind optional und kommen erst wenn die passive Erfassung sauber laeuft.

**Tradeoff:** Reine Bridge-Loesung ist robust und funktioniert auch retroaktiv, aber „stumm" — sie zeigt was passiert, nicht warum. Reine MCP-Steuerung waere erklaerend, aber fragil (Claude muss konsistent zugreifen). Hybrid in dieser Reihenfolge gibt sofort 90 % des Werts und laesst sich spaeter erweitern.

### Phase 16.1: Bridge-Telemetrie (Datenerfassung)

**Aufwand:** ~3-4 h. Ohne UI-Aenderungen — am Ende der Phase liegen Daten in SQLite.

| Feature | Datei(en) | Status |
|---------|-----------|--------|
| ⏳ SQLite-Schema `session_timeline` | `db.rs`, `migrations` | id, session_id, tool_id, tool, file_path, timestamp, action (read/edit/write/glob/grep/bash), before_hash, after_hash, line_start, line_end, payload_json |
| ⏳ Telemetry-Modul | `telemetry.rs` (NEU) | `record_tool_event(session_id, ev)`, dedupliziert nach tool_id, schreibt in `session_timeline` |
| ⏳ Hook in claude.rs | `claude.rs` | In `handle_bridge_message` bei `tool-start`/`tool-end`/`checkpoint-after` jeweils `telemetry::record_*` aufrufen |
| ⏳ Before/After-Snapshots | `db.rs` | Zusaetzlich zu Checkpoint-Tabelle: dauerhafter Diff pro Edit gespeichert (komprimiert), nicht nur fuer Rewind |
| ⏳ Tauri-Command `presentation_get_timeline` | `teaching.rs` | Liefert Timeline einer Session (live oder historisch) |
| ⏳ Tauri-Event `timeline-append` | `claude.rs` | Pro neuem Eintrag — Frontend kann live mitschreiben |

**Risiko:** Datenmenge bei langen Sessions. Mitigation: Before/After als komprimiertes Diff (zstd), nicht als Volltext doppelt.

### Phase 16.2: 3-Spalten-Layout im Praesentations-Fenster

**Aufwand:** ~2-3 h. Reines Layout — die Spalten zeigen erstmal Platzhalter, Logik kommt in 16.3-16.5.

| Feature | Datei(en) | Status |
|---------|-----------|--------|
| ⏳ PaneForge-Layout | `presentation/+page.svelte` | 3 PaneGroups: 22 % / 56 % / 22 %, resizable, persistente Breiten |
| ⏳ Mode-Toggle | `presentation/+page.svelte` | Knopf in Footer: „Slides" (alter Modus) ↔ „Replay" (neues Layout). Slide-Modus bleibt fuer Mermaid/Code/Text erhalten |
| ⏳ Container-Komponenten | `FileTree.svelte`, `Workspace.svelte`, `Timeline.svelte` (NEU) | Skelette, in den naechsten Phasen befuellt |
| ⏳ Default-View | `presentation/+page.svelte` | Bei offenem Fenster und neuer Tool-Aktion automatisch in Replay-Modus wechseln |

### Phase 16.3: Datei-Baum mit Live-Markierung

**Aufwand:** ~3 h.

| Feature | Datei(en) | Status |
|---------|-----------|--------|
| ⏳ Tree-Aufbau aus Timeline | `FileTree.svelte` | Pfade aus Timeline-Eintraegen → hierarchischer Baum, Ordner-Knoten implizit |
| ⏳ Status-Farbcodierung | `FileTree.svelte` | grau=unbekannt, blau=gelesen, gruen=geaendert, gelb=erstellt, rot=geloescht, pulsierend=aktuell aktiv |
| ⏳ Auto-Expand bei Aktivitaet | `FileTree.svelte` | Wenn Datei in der Timeline auftaucht, Pfad bis zur Wurzel auffalten |
| ⏳ Klick auf Datei | `FileTree.svelte` → `Workspace.svelte` | Mitte zeigt letzten bekannten Stand + alle Edits dieser Datei untereinander |
| ⏳ Mini-Counter pro Knoten | `FileTree.svelte` | „edited.ts (3 ✏️)" — Anzahl Aenderungen direkt am Knoten |

**Risiko:** Bei sehr breiten Repos wird der Tree unuebersichtlich. Mitigation: Nur Pfade die in der Timeline auftauchen — kein vollstaendiger Filesystem-Scan. Maximal 200 Knoten sichtbar, Rest collapsed.

### Phase 16.4: Workspace (Mitte) — Edit-Replay

**Aufwand:** ~2 h. Bauteile (`AnimatedFileEdit`) sind da, fehlen nur Verkettung und Auswahl-Logik.

| Feature | Datei(en) | Status |
|---------|-----------|--------|
| ⏳ Aktive Datei-Anzeige | `Workspace.svelte` | Eine Datei zur Zeit, Header mit Pfad + „aktiv"/„abgeschlossen" Status |
| ⏳ Edit-Liste pro Datei | `Workspace.svelte` | Wenn mehrere Edits an gleicher Datei: chronologische Liste, jeder Edit als Karte mit Before/After-Diff |
| ⏳ Replay-Knopf pro Edit | `Workspace.svelte`, `AnimatedFileEdit.svelte` | Klick spielt die Animation erneut ab — `{#key}` fuer Reset |
| ⏳ Lese-Operationen anzeigen | `Workspace.svelte` | Read/Glob/Grep nicht animiert sondern als kompakte Eintraege („Gelesen: Zeilen 5-50") |
| ⏳ Bash-Snippets | `Workspace.svelte` | `Bash`-Calls als Terminal-Card mit Befehl + Output-Snippet |

### Phase 16.5: Timeline (Rechts) — Chronologische Navigation

**Aufwand:** ~2 h.

| Feature | Datei(en) | Status |
|---------|-----------|--------|
| ⏳ Vertikale Timeline | `Timeline.svelte` | Chronologisch, neueste oben, Zeitstempel + Tool-Icon + Pfad-Snippet |
| ⏳ Filter-Chips | `Timeline.svelte` | Nur Edits / Nur Reads / Nur Bash / Alle — schmale Toggle-Reihe |
| ⏳ Klick → Workspace + Tree | `Timeline.svelte` | Klick aktiviert Datei in Tree und zeigt diesen Edit in Mitte |
| ⏳ Live-Indikator | `Timeline.svelte` | Pulsierender Punkt am neuesten Eintrag waehrend Session laeuft |
| ⏳ Session-Wechsler | `Timeline.svelte` | Dropdown oben: aktuelle Session / historische Sessions, laedt jeweilige Timeline |

### Phase 16.6: Optional — MCP-Tools fuer gezielte Erklaerung

**Aufwand:** ~3 h, optional. Erst nach 16.1-16.5 sinnvoll, vorher kein Mehrwert.

**Konzept:** Wenn das Praesentations-Fenster offen ist, bekommt Claude per System-Prompt-Hint einen MCP-Server `presentation` mit drei Tools. Sie kann sie nutzen — muss aber nicht. Bridge-Telemetrie laeuft unabhaengig weiter.

| Tool | Wirkung |
|------|---------|
| `present_focus(file, line_start?, line_end?)` | Markiert Datei + Zeilenbereich im Workspace, scrollt dorthin |
| `present_explain(text, anchor?)` | Sprechblase rechts neben Workspace, optional an Datei/Zeile gepinnt |
| `present_diagram(mermaid)` | Modal mit Mermaid-Diagramm — fuer Architektur/Flow-Erklaerungen |

**Tradeoff:** Claude muss daran denken, das ist anfangs flackernd. System-Prompt sollte „nutze diese Tools sparsam, nur fuer Schluesselstellen" sagen, sonst wird's Spam.

### Phase 16.7: Polish + Export

**Aufwand:** ~2 h.

| Feature | Datei(en) | Status |
|---------|-----------|--------|
| ⏳ Geschwindigkeitssteuerung global | `presentation/+page.svelte` | Speed-Steps wirken jetzt fuer alle Edits — auch beim Replay alter Eintraege |
| ⏳ Pause/Resume bei Live | `presentation/+page.svelte` | „Pause" friert Tree+Timeline ein, neue Eintraege werden gepuffert, „Resume" arbeitet sie ab |
| ⏳ Session-Export | `teaching.rs` | „Schulungsvideo" als JSON-Bundle exportieren — laed't in einer anderen Instanz wieder |
| ⏳ Hotkeys | `presentation/+page.svelte` | j/k = Timeline rauf/runter, Enter = Replay, t = Tree-Fokus |

---

**Gesamt-Aufwand Phase 16 (ohne 16.6):** ~14-16 h, in 6 zusammenhaengenden Sub-Phasen. Jede Sub-Phase ist fuer sich nuetzlich — auch wenn nur 16.1-16.3 fertig werden, ist das schon ein lebender Datei-Baum mit Telemetrie-Backend.

**Reihenfolge-Begruendung:** Telemetrie zuerst (16.1) — ohne Daten kein UI. Layout-Skelett (16.2) gibt einen Rahmen zum Befuellen. Dann von links nach rechts (16.3 Tree → 16.4 Workspace → 16.5 Timeline) weil das die natuerliche Lesereihenfolge des Users ist. Polish (16.7) am Ende. MCP (16.6) nur wenn Phase 16.1-16.5 stabil sind.

---

## Technische Schulden

| Was | Prioritaet |
|-----|-----------|
| TypeScript strict mode | Niedrig |
| E2E Tests (Playwright) | Mittel |
| ✅ Cargo warnings eliminieren | Erledigt — 0 Warnings |
| Dead Code in alten Panels | Niedrig |
| ✅ Bridge Error-Handling verbessern | Erledigt — Global Handler, Parse-Logging, .catch() |

---

## Nicht geplant

- Multi-User / Team-Features
- Cloud-Sync
- Plugin-System (overkill fuer 1-User-App)
- Electron-Port (Tauri bleibt)

---

## Build & Entwicklung

```bash
# Dev (Hot-Reload)
cd "/mnt/17 - Entwicklungen/20 - Projekte/ClaudeDesktop"
CARGO_TARGET_DIR=/tmp/claude-desktop-target nix-shell --run "npx tauri dev"

# Produktion
CARGO_TARGET_DIR=/tmp/claude-desktop-target nix-shell --run "npx tauri build -- --bundles appimage"

# CI: Commit mit [appimage] → Forgejo Runner baut + uploaded
```