How to preview Markdown files from Claude Code and Codex

A developer published a guide on previewing Markdown files written by coding agents such as Claude Code and Codex, recommending the terminal renderer Glow (brew install glow) and macOS's open command for viewing agent-generated plans like PLAN.md. The guide also suggests adding a line to AGENTS.md or CLAUDE.md instructing agents to run open on every Markdown file they write, and notes that PonyMux's Files panel renders Markdown beside the terminal via Cmd-Option-F.

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: glow PLAN.md renders headings, lists, tables, and code right there. Install it with brew install glow . open PLAN.md opens it in whatever app handles .md files on your Mac. AGENTS.md or CLAUDE.md telling it to run open on every Markdown file it writes. Use a Markdown renderer. Glow https://github.com/charmbracelet/glow is a common one: brew install glow glow PLAN.md 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. macOS has a command for that: open PLAN.md 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. 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 https://ponymux.com/guides/hand-off-claude-code-to-codex how-do-i-make-every-agent-follow-the-same-project-rules . 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 https://ponymux.com 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. A file gets there three ways: pony open PLAN.md pony open <file in the line above instead of open <file , and a brief note shows which agent opened the file. 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 https://ponymux.com/docs/workspace-navigation files and pony CLI https://ponymux.com/docs/pony-cli . Originally published on ponymux.com https://ponymux.com/guides/preview-markdown-files-claude-code-codex , where the demos are interactive.