spacebarRead CLAUDE.md And Plans In Finder
CLAUDE.md, AGENTS.md, plans and READMEs, rendered in Finder and live as they change
Claude Code reads CLAUDE.md, other agents AGENTS.md, and they write plans and READMEs as they go. Quick Look shows them as plain text; spacebar renders them on Space and redraws as they change.
A free Quick Look replacement, not an IDE: the plan, the logged JSON, the report and the changed code, each one Space away.
- Watch a plan growRedraws on each save, keeping your place.
- Tick and fix in placeTick a task or fix a line of
CLAUDE.md; it saves.
If the agent changed the file meanwhile, its change stays on disk and a banner lets you keep yours, use the disk version, or copy your text. See editing Markdown in Quick Look.
The Folder In The Sidebar
A click shows any file in the folder: Markdown, HTML reports, code, JSON as a tree, CSV, images and PDFs. Links between notes open in place.
With the optional Space helper, which needs Accessibility, Space opens PDFs, photos, CSV and nearly every other file in spacebar.
Dot folders such as .claude stay hidden unless you turn on hidden files (Settings › Advanced). In Finder, ⌘ ⇧ . shows them too, and spacebar follows.
Search A Repo And Read Its Diffs
- Contents searchNames | Contents searches every file’s text, skipping
node_modules. - Diffs
.diff,.patchand```difffences: added lines green, removed red.
Footnotes and heading anchors work in long reports.
Safe For Untrusted Files
Markdown is sanitized, remote images are off by default, and downloaded HTML runs no scripts.
More: Markdown, Mermaid, Obsidian, QLMarkdown, compare.
Questions
Does it update while the agent writes?
Yes. It redraws each time the file is saved, and keeps your place.
What if the file changes while I’m editing it?
The agent’s change stays on disk, and a banner lets you keep yours, use the disk version, or copy your text.
Can I see the .claude folder?
Dot folders such as .claude stay hidden unless you turn on hidden files in Settings › Advanced. In Finder, ⌘ ⇧ . shows them too, and spacebar follows.
Is spacebar made by Anthropic?
No. spacebar is an independent, open-source project, not affiliated with Anthropic.
Install
Or paste this in Terminal
curl -fsSL https://spacebar.patebryant.com/install.sh | sh
Free and open source for macOS 13 or later. spacebar is an independent project, not affiliated with Anthropic.