md-viewer: A Live-Reloading Markdown Viewer for Claude Code Workflows
md-viewer is a lightweight markdown viewer built specifically for developers using Claude Code to generate documentation. It provides live-reloading functionality that automatically updates when Claude modifies markdown files, eliminating the need to switch between terminal and editor windows.
Key Features
The tool addresses specific pain points when working with AI-generated documentation:
- Live reload by default: When Claude updates a file, the viewer re-renders automatically without manual refresh
- Independent file watching: Unlike VS Code preview, md-viewer watches files independently without requiring them to be open in an editor
- File explorer sidebar: Browse between documentation files without leaving the viewer
- Mermaid diagram support: Renders architecture diagrams natively when Claude generates them in markdown
- Tabbed interface: Open multiple documents across different projects simultaneously
- Lightweight footprint: Approximately 35 MB, only links libc, and opens instantly
Installation Options
The tool is available through multiple package managers:
# AUR (Arch-based)
yay -S md-viewer-git
Snap
sudo snap install md-viewer
Cargo (Rust)
cargo install md-viewer
Usage
Basic usage is straightforward:
- Open md-viewer on a second monitor or tiled next to your terminal
- Point it at your project's CLAUDE.md file or docs/ folder
- Use
md-viewer path/to/file.mdor drag and drop files - No "Open Folder" required - works with individual files
The tool is built with Rust and egui, and currently supports Linux only (both X11 and Wayland). It functions as a read-only companion for AI-assisted development, designed to stay open alongside terminal sessions throughout the workday.
📖 Read the full source: r/ClaudeAI
👀 See Also
Benchmark Results: Claude Agent Swarm with Memory System Shows 30-43% Token Cost Savings
A developer tested a 6-agent Claude swarm on a 40-point coding task with and without a custom memory system called Stompy. Results show Sonnet 4.6 with memory achieved perfect scores at $3.98 vs $7.04 without, while Haiku 4.5 failed completely without memory but scored 39/40 with it.
BracketMadness.ai: March Madness Bracket Challenge for AI Agents
BracketMadness.ai is a March Madness bracket challenge designed specifically for AI agents, where agents autonomously read API docs, register themselves, pick all 63 games, and submit brackets. The site serves plain-text API instructions to agents while showing a normal visual interface to humans.
Semble: Code Search for AI Agents Using 98% Fewer Tokens Than grep+read
Semble is an open-source code search library for AI agents that combines static Model2Vec embeddings with BM25, running entirely on CPU. It indexes a repo in ~250ms and answers queries in ~1.5ms, achieving 0.854 NDCG@10 — 99% of a 137M-parameter transformer's quality — while using 98% fewer tokens than grep+read.
InsForge: Self-Hosted Postgres Backend with MCP Integration for AI Coding Agents
InsForge is an open-source, self-hosted backend alternative to Supabase that connects to Claude Code via MCP, allowing AI agents to see schema, policies, and service state. It includes PostgreSQL 16.4, PostgREST, Deno Runtime, auth, storage, and edge functions.