Marky: A Lightweight Markdown Viewer for Agent-Generated Documentation

What Marky Does
Marky is a native desktop application for macOS that provides fast rendering of markdown files with a focus on terminal integration. You can launch it with marky FILENAME to view a single file or marky FOLDER to open a folder as a persistent workspace.
Key Features
- CLI-first workflow: Open files directly from terminal commands
- Live reload: Edits on disk update the view instantly, useful for viewing Claude-generated plans or documentation as they're written
- Folder workspaces: Add folders as persistent workspaces that appear in a sidebar and restore on launch
- Command palette: Cmd+K for fuzzy-search files across all open folders using nucleo
- Syntax highlighting: Shiki with VS Code themes for accurate code blocks
- Math support: KaTeX rendering for $inline$ and $$display$$ math
- Diagrams: Mermaid blocks render as SVG
- GFM support: Tables, task lists, strikethrough, autolinks, footnotes
- Light & dark themes: Follows system preference or manual toggle
- Sanitized rendering: All HTML runs through DOMPurify for safe viewing of untrusted markdown
- Small footprint: Native webview (no Electron) with production .dmg under 15 MB
Installation
Currently available via Homebrew (note: app is not signed while waiting for Apple developer review):
brew tap GRVYDEV/tap
brew install --cask GRVYDEV/tap/marky
xattr -cr /Applications/Marky.appOr build from source (requires Rust, Node.js, and pnpm):
git clone https://github.com/GRVYDEV/marky.git
cd marky
pnpm install
pnpm tauri build
./scripts/install-cli.shKeyboard Shortcuts
- Cmd+K: Command palette (fuzzy file search)
- Cmd+O: Open file
- Cmd+Shift+O: Add folder
- Cmd+F: Search in page
Technical Stack
- Desktop shell: Tauri v2
- Frontend: React + TypeScript + Vite
- Markdown: markdown-it
- UI primitives: shadcn/ui
- Styling: Tailwind CSS
- File watching: notify
Roadmap
The developer plans to add x86 & Linux support (currently macOS ARM only), built-in AI chat for interacting with Claude Code or Codex directly within markdown documents, and git diff review functionality for local code review.
📖 Read the full source: HN AI Agents
👀 See Also

Real-time stock analysis added to Claude Desktop via MCP server
A developer built an MCP server called agent-toolbelt that adds real-time stock analysis capabilities to Claude Desktop and Claude Code, providing live data for investment analysis instead of Claude's training data guesses.

Claude Code Karma: Local Observability Dashboard for Claude Code Sessions
Claude Code Karma is an open-source local dashboard that parses JSONL files from ~/.claude/ to visualize Claude Code session data, track tool usage, and monitor silent failures. Built with FastAPI, Svelte-Kit 2, Svelte 5, and SQLite, it provides full session timelines and live tracking.

How AI assistants fetch web pages: Nginx log analysis of ChatGPT, Claude, Gemini and others
A developer tested five major AI assistants by prompting them with unique URLs and monitoring Nginx logs, revealing distinct retrieval patterns: ChatGPT, Claude, and Perplexity use dedicated user-agents while Gemini answered from its index without fetching.

How Mendral Cut LLM Costs by Upgrading to Opus: Triager Pattern, SQL Access, and Sub-Agent Architecture
Mendral switched from Sonnet to Opus 4.6 for CI failure analysis but reduced costs by using a Haiku triager to divert 80% of failures, giving agents SQL access to ClickHouse instead of pushing logs, and spawning cheap sub-agents to do the actual digging.