7. Die wichtigste Lektion

Die wichtigste Lektion

Was passiert ist

An einem Abend verschwand die Thread-History in ZED. Die Reaktion: SQLite-Datenbanken öffnen, kv_store-Einträge manuell editieren, WAL-Dateien committen, Binary-Strings durchsuchen, Hypothesen testen.

Stunden später. Kein Ergebnis.

Die Lösung: Die offizielle ZED-Dokumentation aufrufen. Zeitaufwand: 5 Minuten. Erkenntnis (damals): External Agents wie Claude Code Tab unterstützen Thread History Restore in ZED’s UI — so stand es in der Doku.

Was wir gelernt haben

Über ZED:

Es gibt drei völlig verschiedene KI-Systeme (Text Thread, Agent Panel, External Agents)
Thread History für externe Agenten ist eine bekannte, dokumentierte Einschränkung
“Delete All History” löscht nur den Index, nicht die Daten

Über professionelles Arbeiten:

Bei tool-spezifischen Problemen: erst Docs, dann Debugging
Wenn ein Verhalten sich plötzlich ändert: Fast immer Architektur oder Konfiguration
Datenbank-Manipulation ohne Verständnis des Schemas führt zu Zeitverlust, nicht zu Lösungen

Die Regel

Docs first. Debug second.

Das gilt für ZED. Das gilt für jedes Tool. Das ist keine Selbstverständlichkeit — es muss bewusst praktiziert werden.

Wenige Stunden später …

Die Lektion bleibt gültig — aber die Geschichte hat eine Fortsetzung, die größer ist. Von der Idee bis zum produktionsfähigen XED /TUI Agentic Coding Tool vergingen nur wenige Stunden. Wie war das möglich?

Erstens: ZED zeigt die Claude Code Sessions längst im History-Panel. Es liest ~/.claude/projects/ direkt — clever, still, ohne Aufsehen. Was wir stundenlang gesucht haben, war die ganze Zeit da.

Zweitens: Die Sessions als Dateien eröffnen eine neue Dimension. Jede .jsonl unter ~/.claude/projects/<slug>/ ist ein vollständiger Transcript. Jede Zeile: ein JSON-Objekt. Menschenlesbar, maschinenverarbeitbar, archivierbar.

Daraus entstand xed-tui.py — eine mutt-artige “XED /TUI”:

XED /TUI Screenshot

Was das Tool schon kann:

4-Panel-Layout — Projekte · Sessions · Reader · Notizen, Side-by-Side mit Auto-Swap
Session-Browser — alle ~/.claude/projects/ sortiert nach Zeit und Aktivität
Reader — vollständiger Transcript, gescrollt wie ein Pager (jk, PgUp/PgDn, gG)
Notizen (e) — pro Session eine memory/<uuid>.md, vorausgefüllt mit dem Transcript, im $EDITOR bearbeitbar
Zwischenablage (c) — Notiz direkt in Clipboard via wl-copy/xclip/xsel
Titel (t oder /rename) — Sessions umbenennen, sichtbar in TUI + Claude Code + ZED History
Refresh (r) — neue Sessions live nachladen ohne Neustart
Löschen (d) — mit Bestätigung (“delete” tippen)
Vollbild-Modi (f/n/m) — Reader-only (Full), Notiz-only, oder Panels tauschen

[a] Agent — Claude Code Agent mit --resume <uuid> direkt aus XED /TUI starten, CWD wird automatisch aus den Session-Metadaten gelesen, die Session wird laufend automatisch gespeichert und XED /TUI übernimmt wieder die Steuerung an der aufrufenden Stelle sobald Claude Code mit /exit verlassen wird. [o] Open — /resume <uuid> in die Zwischenablage kopieren: in der TUI surfen, den Resume-Link direkt in einen laufenden Claude Code einfügen — was ZED’s History-Panel (noch) nicht kann.

Sessions umbenennen, löschen, annotieren, im Editor öffnen, direkt wieder aufnehmen — alles lokal, kein Cloud-Service.

Das Titel-Problem ist gelöst. /rename und [t] schreiben denselben nativen Record ins JSONL — der Titel erscheint danach konsistent in Claude Code /resume, ZED History und der TUI-IDE.

Drittens — und das ist die eigentliche Lektion:

ZED 2026 ist kein Editor mit KI-Addon. Es ist das professionelle Interface, mit dem Human SysOps ihre LLMs dirigieren. Filesystem-Zugriff. ACP-Integration. History. Memory. Open Source.

Docs first. Debug second. Und: Unterschätze nie, was Open Source mit dem richtigen Werkzeug erreicht.

Dieses Buch wurde aus einer echten Session geboren, in der wir gemeinsam auf die harte Tour gelernt haben. Danke für die Ehrlichkeit, die es brauchte, daraus ein Buch zu machen.