{"slug": "show-hn-portable-guided-reviews-you-can-send-as-html", "title": "Show HN: Portable Guided Reviews you can send as HTML", "summary": "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.", "body_md": "[GitHub](https://github.com/plannotator/guides)\n\n# A code walkthrough you can send as a file.\n\nA [Guided Review](https://plannotator.ai/docs/commands/code-review#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.\n\nOpen a real one:\n    [a bug fix, 5 chapters](https://guides.show/g/gs0M7zgI_zYeuqtLG4j5vQ#key=awkuPrNypYrCLT49XVnrRUyzg3Iqb-YB2h9-QEWQWMM)\n[a 125-file feature branch, 6 chapters](https://guides.show/g/Q-ECuRlzn6I2U41wmnyVmA#key=bA52euqWQypYoSC8n9LFXvP9gLsvTMwYtgjvfS0YAQE)\n\n## Making one\n\nAsk your coding agent for a guide of a branch, PR, or commit with the [`plannotator-guide`](https://github.com/plannotator/guides) skill; it writes the chapters and hands you the file. [Plannotator](https://plannotator.ai) users get the same from *Download portable guide* after a Guided Review.\n\n`npx skills add plannotator/guides`\n## Share links\n\nA 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.\n\n## This host\n\nViewer 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`](https://github.com/backnotprop/plannotator/tree/main/apps/guides-show)) you can run yourself.", "url": "https://wpnews.pro/news/show-hn-portable-guided-reviews-you-can-send-as-html", "canonical_source": "https://guides.show/", "published_at": "2026-10-12 18:25:12+00:00", "updated_at": "2026-10-12 18:48:43.947129+00:00", "lang": "en", "topics": ["ai-agents", "developer-tools", "ai-tools"], "entities": ["Plannotator", "plannotator-guide", "guides.show", "Cloudflare Workers", "GitHub"], "also_reported_by": [], "alternates": {"html": "https://wpnews.pro/news/show-hn-portable-guided-reviews-you-can-send-as-html", "markdown": "https://wpnews.pro/news/show-hn-portable-guided-reviews-you-can-send-as-html.md", "text": "https://wpnews.pro/news/show-hn-portable-guided-reviews-you-can-send-as-html.txt", "jsonld": "https://wpnews.pro/news/show-hn-portable-guided-reviews-you-can-send-as-html.jsonld"}}