cd /news/ai-agents/show-hn-portable-guided-reviews-you-… · home › topics › ai-agents › article
[ARTICLE · art-149801] src=guides.show ↗ pub= topic=ai-agents verified=true sentiment=· neutral

Show HN: Portable Guided Reviews you can send as HTML

Plannotator released a portable Guided Review format that exports a code diff walkthrough as a single HTML file, with a companion skill installable via `npx skills add plannotator/guides`. Shared guides are encrypted client-side before upload to the guides.show host, with the decryption key kept in the URL fragment after `#` so the server only stores unreadable bytes, and viewer builds are pinned under `/v1/` so published guides render identically over time. The host runs as a small Cloudflare Worker in the `apps/guides-show` directory that users can self-host.

read1 min views3 publishedOct 12, 2026

GitHub A Guided Review takes a diff and explains it in order of importance: chapters, a short overview for each, and the files that belong to it, with the changes shown alongside. Exported, it is one HTML file. This site serves what displays it, and hosts guides shared as links.

Open a real one:

    [a bug fix, 5 chapters](https://guides.show/g/gs0M7zgI_zYeuqtLG4j5vQ#key=awkuPrNypYrCLT49XVnrRUyzg3Iqb-YB2h9-QEWQWMM)
[a 125-file feature branch, 6 chapters](https://guides.show/g/Q-ECuRlzn6I2U41wmnyVmA#key=bA52euqWQypYoSC8n9LFXvP9gLsvTMwYtgjvfS0YAQE)

Making one #

Ask your coding agent for a guide of a branch, PR, or commit with the plannotator-guide skill; it writes the chapters and hands you the file. Plannotator users get the same from Download portable guide after a Guided Review.

npx skills add plannotator/guides

A guide can be uploaded here instead of downloaded. It is encrypted before it leaves your machine, and the key stays in the link after #, which browsers never send to a server. This host only ever holds bytes it cannot read; anyone with the full link can open the guide, nobody else can. Links don't expire unless asked, and the delete token you get at upload removes one.

This host #

Viewer builds live under /v1/ and never change once published, so a guide from last year opens the same way. A downloaded file sends nothing about your code here. It is a small Cloudflare Worker (apps/guides-show) you can run yourself.

── more in #ai-agents 4 stories · sorted by recency
── more on @plannotator 3 stories trending now
sponsored brought to you by zahid.host 4,200+ EU-deployed projects
reading about agents? ship yours in a single git push.

Run your AI side-project on zahid.host

EU-based hosting, git-push deploys, automatic HTTPS, no cold starts. Free tier with a custom domain — perfect for shipping the agent you just read about.

$git push zahid main
→ Live at https://your-agent.zahid.host ✓
Get free account → Pricing
from €0/mo · no card required
LIVE [news/show-hn-portable-gui…] indexed:0 read:1min 2026-10-12 · —