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
Open-source tool for AI-curated Reddit feeds using Cloudflare, Supabase, and Vercel
A developer open-sourced a self-hosted tool that filters Reddit for quality posts about AI-assisted development, using Cloudflare Workers for cron jobs and proxies, Supabase for storage, and Vercel for the frontend. The tool includes engagement scoring, optional LLM summaries, and costs $1-2/month for AI processing.
Open-Source Claude IDE Bridge Connects Dispatch, Desktop App, and Claude Code
The claude-ide-bridge is an MIT-licensed open-source tool that connects Claude Code to your IDE, providing access to LSP, debugger, terminals, git, and GitHub through 124 tools. It enables a workflow where tasks sent via Dispatch from a phone are handled by the Claude desktop app, which uses Claude Code to write code and run tests while interacting with the IDE.
memv: Open-Source Memory System for AI Agents
memv is an open-source memory system designed for AI agents that stores only unexpected information from interactions, reducing noise and redundancy.
Claude Code v2.1.176: Language-Aware Sessions, Bedrock Credential Caching, and Dozens of Fixes
Session titles now match conversation language; Bedrock credentials cached until expiration; fixed model enforcement bypass for /fast and env vars; tmux clipboard fixes; sandbox symlink fix.