Eine einzige Claude-Code-Sitzung kann einen Haufen Markdown hinterlassen: einen Implementierungsplan, eine Fortschrittsdatei, Rechercheberichte, eine Sitzungszusammenfassung. Irgendjemand muss das alles lesen, und als rohes Markup im Terminal ist das eine Qual — jede Tabelle eine Wand aus Pipes, jede Checkliste eckige Klammern. Hier ist das Setup, mit dem ich KI-Ausgaben am Mac lese.
Schritt 1: Mit der Übersicht sichten
Das meiste, was ein Agent schreibt, braucht zehn Sekunden Überfliegen, keine Lesesitzung. Datei im Finder auswählen, Leertaste, überfliegen, weiter. Von Haus aus zeigt macOS Markdown als reinen Text, du brauchst also eine Erweiterung, die es rendert: QLMarkdown macht das kostenlos (Open Source, auf cmark-gfm gebaut), oder Peekdown (meine App) macht es als Teil eines $4.99-Viewers.
Wenn die Datei noch im Scrollback deines Terminals liegt, rendert glow report.md sie direkt dort, kostenlos (brew install glow). Jede Lese-Option habe ich in der Vorschau-Anleitung behandelt; der Rest dieses Artikels dreht sich speziell um KI-Ausgaben.
Schritt 2: Die Datei beobachten, nicht das Terminal
Agenten überarbeiten ihre Dokumente während der Arbeit: Ein Plan wird geschrieben, überarbeitet, ergänzt. Das Terminal zeigt dir Diffs und Geplauder, nicht den aktuellen Stand der Datei.
Öffne den Plan in Peekdown und stell Einstellungen > Verhalten > Wenn eine Datei extern geändert wird auf Automatisch neu laden. Jetzt aktualisiert sich die Vorschau bei jedem Speichern des Agenten. Ein grüner Pfeil blinkt in der Symbolleiste auf, damit du weißt, dass es passiert ist. Und wenn du eigene ungespeicherte Änderungen hast, während sich die Datei unter dir ändert, zeigt Peekdown einen Konfliktdialog, statt eine der beiden Seiten stillschweigend zu überschreiben.
Zwei Fenstertricks helfen hier. ⌘⇧L und ⌘⇧R legen Fenster auf die linke oder rechte Bildschirmhälfte. Agent auf der einen Seite, Dokument auf der anderen. Und Anheften (das Pin-Symbol in der Symbolleiste oder das Fenster-Menü) hält das Dokument über allem anderen schwebend, was du gerade tust. Nie wieder cat auf dieselbe Datei hämmern, um zu sehen, ob der Agent sie schon angefasst hat.
Schritt 3: Markieren und zurückschicken
KI-Ausgaben lesen ist die halbe Arbeit; die andere Hälfte ist, der KI zu sagen, was sie ändern soll. Dafür sind Peekdowns Anmerkungen da. Wähle gerenderten Text aus, und eine schwebende Werkzeugleiste mit fünf Markierungen erscheint:
- Streichung (S) — das hier löschen
- Sperren (L) — das hier nicht anfassen
- Kommentar (C) — das hier ändern, und zwar so
- Notiz (⌘⇧N) — Anweisungen für das ganze Dokument, etwa "einen Schlussabschnitt ergänzen"
- Blocknotiz (⌘⇧B) — Anweisungen für einen ganzen Absatz, eine Liste oder einen Codeblock
Wenn du fertig bist, kopiert ⌘⌥⇧C alles als strukturierten Prompt — ein JSON-Array, in dem jede Anmerkung Kontext davor und danach mitführt, damit die KI die exakte Stelle findet. Füg ihn in Claude Code, Cursor, ChatGPT ein, was auch immer du benutzt; im Terminal leitet pbpaste | claude ihn direkt hinein. Peekdown löscht die Anmerkungen anschließend, damit die Änderungen der KI auf einem sauberen Dokument landen, behält einen Schnappschuss, falls du sie zurückwillst (⌘⌥⇧Z), und kann den ganzen Satz in eine .json-Datei neben dem Dokument schreiben (⌘⌥⇧E).
Und weil die Datei beobachtet wird, aktualisiert sich das Dokument vor dir von selbst, wenn der Agent deine Korrekturen anwendet.
Die Konfigurationsdateien auch
CLAUDE.md, llms.txt und .cursorrules öffnest du ständig, um nachzusehen, was deinen Tools gesagt wird. Im Grunde sind das Prosa, und Peekdown öffnet und rendert alle drei — ein CLAUDE.md liest sich also wie das Dokument, das es ist.
Das ganze Setup
Eine Übersicht-Erweiterung zum Sichten: QLMarkdown kostenlos, oder die von Peekdown. glow, wenn du im Terminal zu Hause bist. Und für den kompletten Kreislauf Peekdown als Standard-App: automatisches Neuladen an, den Plan neben dem Agenten angeheftet, Anmerkungen für die Korrekturen. Peekdown kostet $4.99 einmalig und braucht macOS 15.0 oder neuer; die Sichtungs-Hälfte davon kostet überhaupt nichts. Falls du noch einen Viewer aussuchst, vergleicht die Übersicht der Viewer sieben davon.