Markdown-Dateien von Claude Code und Codex bequem lesen
Claude Code und Codex schreiben Pläne und Übergaben als Markdown-Dateien, die im Terminal meist nur als roher Quelltext erscheinen. Mit Tools wie glow lassen sich Überschriften und Formatierungen direkt in der Kommandozeile sauber darstellen.
Veröffentlicht am 9. Okt. • Zuerst veröffentlicht auf ponymux.com
Claude Code hat gerade den Plan in PLAN.md geschrieben, oder Codex hat eine HANDOFF.md hinterlassen. Man gibt sie mit cat aus und scrollt durch Rautezeichen, Sternchen und senkrechte Striche. Die Agents rendern Markdown zwar in ihren eigenen Antworten, aber eine Datei, die sie schreiben, liest man im Rohformat. Es gibt einige Möglichkeiten, sie ordentlich zu lesen.
Verwende einen Markdown-Renderer. Glow ist ein verbreiteter Vertreter:
brew install glow glow PLAN.md Vollbildmodus aktivieren Vollbildmodus beenden Er gibt die Datei mit formatierten Überschriften, Aufzählungslisten, Tabellen und hervorgehobenen Codeblöcken aus und kehrt dann zum Prompt zurück. Bei einer langen Datei öffnet glow -p PLAN.md sie in einem Pager, durch den man mit den Pfeiltasten scrollen und den man mit q verlässt.
Glow kann auch aus einer Pipe lesen, daher funktioniert cat NOTES.md | glow - ebenfalls. Das ist der schnellste Weg, einen Plan zu lesen, ohne das Terminal der Sitzung zu verlassen, aber es ist ein Schnappschuss: Wenn der Agent die Datei erneut bearbeitet, muss man den Befehl erneut ausführen.
open PLAN.md Vollbildmodus aktivieren Vollbildmodus beenden Damit öffnet sich die Datei in der App, die dein Mac für.md-Dateien verwendet, etwa dein Editor oder eine Markdown-App. Um festzulegen, welche App das ist, wähle eine beliebige.md-Datei im Finder aus, drücke Cmd-I, wähle eine App unter Öffnen mit und klicke auf Alle ändern.
Das funktioniert von überall, auch aus dem Agent selbst, da es ein gewöhnlicher Shell-Befehl ist.
Ja. Agents lesen deine Projekthinweise zu Beginn jeder Sitzung, daher reicht eine einzige Zeile aus. Füge sie in AGENTS.md ein, die von Codex und Grok Build gelesen wird, oder in CLAUDE.md für Claude Code:
- Wenn du einen Markdown-Plan oder eine Notiz schreibst oder aktualisierst, führe `open <file>` aus, damit ich sie lesen kann. Vollbildmodus aktivieren Vollbildmodus beenden Von da an sollte der Agent, wenn er PLAN.md schreibt, abschließend open PLAN.md ausführen, und die Datei öffnet sich in deiner Markdown-App. Wenn beide Agents im Projekt arbeiten, füge die Zeile in AGENTS.md ein und lasse CLAUDE.md sie mit @AGENTS.md importieren; siehe How to hand off a task from Claude Code to Codex.
Ja. Wenn Claude Code eine Datei schreibt oder bearbeitet, gibt es den Dateinamen als Terminal-Link aus. In Terminals, die Links unterstützen, wie Ghostty und iTerm2, hält man Cmd gedrückt und klickt auf den Namen, woraufhin sich die Datei in der Standard-App öffnet.
Das ist praktisch, wenn der Agent nebenbei eine Datei erwähnt. Man muss den Pfad neither kopieren noch zum Finder wechseln.
Ja. PonyMux hat ein Files-Panel, das Markdown neben dem Terminal rendert: Überschriften, Codeblöcke, Tabellen, Aufgabenlisten und Bilder. Mit Cmd-Option-F blendet man es ein.
PonyMux' Files-Panel rendert eine Markdown-Datei neben dem Terminal, mit Vor- und Zurück-Navigation und einem Pin-Button.
Man kann bis zu 10 Dateien anheften. Das Panel ist zum Lesen gedacht; zum Bearbeiten öffnet man die Datei über das Kontextmenü in seinem Editor. Mehr zum Panel und zum pony-Befehl findet man unter Workspace and Navigation und pony CLI.
Zuerst veröffentlicht auf ponymux.com, wo die Demos interaktiv sind.
Automatisch übersetzt. Das Original auf Englisch ist unten aufklappbar.
Original (Englisch) anzeigen
Posted on Oct 9 • Originally published at ponymux.com
Claude Code just wrote the plan to PLAN.md, or Codex left a HANDOFF.md. You cat it and scroll through pound signs, asterisks, and pipes. The agents render Markdown in their own replies, but a file they write you read raw. A few ways to read it properly:
Use a Markdown renderer. Glow is a common one:
brew install glow glow PLAN.md Enter fullscreen mode Exit fullscreen mode It prints the file with styled headings, bullet lists, tables, and highlighted code blocks, then returns to the prompt. For a long file, glow -p PLAN.md opens it in a pager you can scroll with the arrow keys and leave with q.
Glow reads from a pipe too, so cat NOTES.md | glow - works. It's the quickest way to read a plan without leaving the session's terminal, but it's a snapshot: when the agent edits the file again, run it again.
open PLAN.md Enter fullscreen mode Exit fullscreen mode It opens the file in the app your Mac uses for.md files, such as your editor or a Markdown app. To change which app that is, select any.md file in Finder, press Cmd-I, pick an app under Open with, and click Change All.
This works from anywhere, including from the agent itself, since it's an ordinary shell command.
Yes. Agents read your project instructions at the start of every session, so one line is enough. Add it to AGENTS.md, which Codex and Grok Build read, or to CLAUDE.md for Claude Code:
- After you write or update a Markdown plan or note, run `open <file>` so I can read it. Enter fullscreen mode Exit fullscreen mode From then on, when the agent writes PLAN.md, it should finish by running open PLAN.md, and the file comes up in your Markdown app. If both agents work in the project, put the line in AGENTS.md and have CLAUDE.md import it with @AGENTS.md; see How to hand off a task from Claude Code to Codex.
Yes. When Claude Code writes or edits a file, it prints the file name as a terminal link. In terminals that support links, such as Ghostty and iTerm2, hold Cmd and click the name, and the file opens in its default app.
That's handy when the agent mentions a file in passing. You don't have to copy the path or switch to Finder.
Yes. PonyMux has a Files panel that renders Markdown beside the Terminal: headings, code blocks, tables, task lists, and images. Press Cmd-Option-F to show it.
PonyMux's Files panel rendering a Markdown file next to the Terminal, with back/forward navigation and a pin button.
You can pin up to 10 files. The panel is for reading; to edit, open the file in your editor from its context menu. For more on the panel and the pony command, see Workspace and Navigation and pony CLI.
Originally published on ponymux.com, where the demos are interactive.