SkimDown is a native macOS, read-only viewer for reading the Markdown folders produced by AI agents and development tools. Open a folder and it shows only .md / .markdown files in a sidebar tree, then renders the selected file in a simple preview with no editing controls at all. It is built around a single idea: specs, notes, execution logs — the Markdown an AI agent churns out one file after another — should be organized purely for reading. Development has continued since launch, with YAML frontmatter rendering added on August 19, 2026.
Key Features
- A tree view that pulls out only Markdown files: Open a folder and SkimDown recursively detects
.md/.markdownfiles, then displays a tree in the sidebar with hidden files and build-output directories excluded. Empty folders containing no Markdown are omitted, so even the messy directory structures an AI agent generates stay easy to navigate. - A read-only preview that never edits or saves: The preview is built on
WKWebViewand is strictly for viewing — no editing, saving, exporting, or printing. It runs on bundled rendering assets, so no CDN connection is required. - Live reload keeps up with files still being written: SkimDown watches the filesystem for Markdown additions, deletions, renames, and updates, and refreshes the tree and preview automatically. You can follow the logs and reports an agent writes mid-run in real time.
- Extended syntax and YAML frontmatter rendering: Footnotes, math (KaTeX), Mermaid diagrams, GitHub-style alerts, and emoji shortcodes all render. Frontmatter display in the preview arrived on August 19, 2026.
- Fully local, no telemetry: SkimDown performs no network communication, so the contents of the Markdown you open never leave your machine. You can open multiple folders in separate windows, and it remembers sidebar position and width, theme, font size, recent folders, and expansion state.
Pros and Cons
✅ Pros
- The read-only design means there is no way to accidentally overwrite or delete a file an AI agent generated
- Live reload lets you watch Markdown appear in real time while an agent is still running
- Nothing goes over the network, so privacy concerns are minimal even with confidential specs or logs
- Open source (GPL-3.0) and free, so you can inspect the source before trusting it
- KaTeX, Mermaid, GitHub alerts, and other syntax AI agents tend to emit render correctly with no extra configuration
⚠️ Cons
- Requires macOS 26 (Tahoe) or later; there is no official native build for earlier macOS versions, Windows, or Linux (Windows has an unofficial community build only)
- The distributed DMG is ad-hoc signed, so first launch requires manually clearing the Gatekeeper quarantine attribute from the terminal
- Being read-only, you cannot edit Markdown in place while looking at the preview
- No filename search or cross-file search — search is limited to the currently open file
- Released in April 2026, so community track record and reviews are still thin
Comparison with Similar Tools
| Criteria | SkimDown | Obsidian | Typora | VS Code (Markdown preview) |
|---|---|---|---|---|
| Primary use | Viewing AI-generated Markdown folders | Building and editing a Markdown-based knowledge base | Markdown writing, WYSIWYG editing | Preview alongside code editing |
| Editing | None (read-only) | Yes | Yes | Yes |
| Platforms | macOS 26+ (Windows / GitHub Copilot App are unofficial community builds) | macOS/Windows/Linux/mobile | macOS/Windows/Linux | macOS/Windows/Linux |
| Network traffic | None (fully local) | Depends on plugins (sync features do communicate) | None | Depends on extensions |
| License | Free, open source (GPL-3.0) | Free for personal use, paid plans for commercial use | Paid, one-time purchase | Free, open source |
The defining difference is that SkimDown narrows its scope to “read, don’t edit.” Obsidian and Typora are editing tools aimed at note-taking and writing, and for the sole purpose of safely browsing large volumes of AI-generated Markdown, they tend to be more tool than you need. SkimDown deliberately goes the other way.
Who It’s For
- Anyone who wants to read the specs, design notes, and execution logs that AI coding agents like Claude Code or Codex generate, without worrying about editing them by mistake
- Developers who want a quick look at the Markdown documentation piling up in a repository without opening an editor
- Anyone who wants Markdown viewing to stay fully local with no network traffic (internal documents, sensitive specs, and the like)
- Anyone on macOS 26 (Tahoe) who wants Markdown containing Mermaid diagrams and KaTeX math to render correctly
Conclusion
SkimDown is a native macOS app that narrows its feature set to one thing: reading the Markdown an AI agent wrote. Dropping editing removes the risk of damaging files, and between live reload and fully local operation, you can safely follow documents while an agent is still working on them. The macOS 26 requirement is a real constraint, but as AI agent development becomes part of the everyday workflow, tools built specifically for reading look set to matter more, not less.