View and share HTML/Markdown reports from AI coding agents.

Run this in your terminal — no install needed:

Live demo →

_{Download binary · npm}

"HTML is the new markdown. I've stopped writing markdown files for almost everything and switched to using Claude Code to generate HTML for me."

— Thariq Shihipar, Engineering Lead, Claude Code at Anthropic · 5M+ views

The problem

Claude Code, Codex, and Cursor generate rich HTML reports — data visualizations, research analyses, interactive charts. But there's no good way to view or share them:

• VS Code Live Preview breaks over SSH and WSL
• GitHub won't render HTML — only Markdown
• python -m http.server gives you a raw directory listing
• Sharing means downloading files and emailing them around

What viewllm does

Run it in any project folder. You get:

• Real-time file watching — new and modified files appear with unread indicators as your agent produces them
• Sharing — shareable links to specific reports. Add -tunnel for a public URL, no port forwarding needed
• Per-device unread tracking — each person who opens the link gets their own read/unread state
• Search — file tree, search bar, hover preview popups on all file items, thumbnails, text snippets
• HTML and Markdown — renders both. Markdown gets GitHub-style formatting
• SSH, WSL, remote servers — works anywhere you have a terminal
• Themes — Light, Dark, Solarized

Lightweight

Single Go binary. No database, no config files, no background processes. Read-only. Stop it and it's gone.

Quick start

Ask your AI coding agent:

"Write me an HTML report analyzing the architecture of this codebase. Include diagrams, dependency graphs, and your recommendations."

Then:

Install

npx (zero install, always latest):

Binary — grab from GitHub Releases:

curl -fsSL https://github.com/yz671/viewllm/releases/latest/download/viewllm-linux-amd64 -o viewllm
chmod +x viewllm
./viewllm

git clone https://github.com/yz671/viewllm.git && cd viewllm
go build -o viewllm . && ./viewllm

Sharing

viewllm shows a shareable link on startup:

viewllm serving ./reports

  Open: http://192.168.1.42:8090
  To share over the internet, use -tunnel

For sharing beyond your network — no accounts, no port forwarding:

npx viewllm@latest -tunnel

viewllm serving ./reports — starting tunnel (powered by Cloudflare)...

  Share this link: https://random-words.trycloudflare.com

  Anyone with this link can view your reports.
  This link expires when you stop viewllm — a new one is created each time.

Works with any tool

Works with Claude Code, Codex, Cursor, Jupyter, and anything else that outputs .html or .md files.

Usage

viewllm [directory] [-p port] [-exclude dir]... [-exclude-file name]... [-tunnel]

Serves the current directory by default. Finds an open port automatically.

GET /              → Web UI
GET /api/recent    → Recently modified files (with previews)
GET /api/tree      → Full directory tree as nested JSON
GET /api/excludes  → Current exclude patterns
GET /files/{path}  → Serves HTML directly, renders Markdown as styled HTML

Contributing

The codebase is intentionally simple — two files:

main.go              → Server, API, file scanning (~650 lines)
frontend/index.html  → Entire UI, embedded into the binary (~40KB)

License

MIT