Pagelet Run locally

Pagelet

Review agent-generated HTML reports with element-pinned comments, versioned publishes, and Markdown feedback your coding agent can use.

Run locally See workflow
Pagelet report viewer with comment pins and comments sidebar

A review loop for coding agents

Pagelet keeps the report, reviewer feedback, and next agent task in one narrow path.

  1. 01 Publish

    Send a local HTML report and assets from the CLI.

  2. 02 Review

    Open the private viewer and comment directly on report elements.

  3. 03 Export

    Generate feedback Markdown with anchors, comments, and replies.

  4. 04 Republish

    Let the coding agent revise the report and publish a new version.

Built for report review, not generic docs

The surface is intentionally small: enough product to review generated reports without turning the workflow into a CMS.

Inspector comments

Highlight report elements and pin comments with selector-backed anchors.

Immutable versions

Each publish is preserved so reviewers can compare current and historical reports.

Agent-ready feedback

Export comments as Markdown that gives coding agents clear repair context.

Self-hosted shape

Run one tenant with your own auth, storage bucket, and domain allowlist. No database.

Your reports stay in your deployment

Pagelet is designed for teams that want agent-assisted reporting without handing report artifacts to a shared SaaS by default.

Why not just serve the file yourself?

You can, and for a report only you will read, you should — python -m http.server is thirty seconds of work. What it doesn't give you: a link that works for someone without your repo, comments anchored to elements that survive a republish, immutable versions, or feedback that returns in a form your agent can act on without you transcribing it.

It doesn't spend your context window

The agent never re-reads the report HTML. It reads a Markdown digest that costs roughly as many tokens as the comments themselves, and the CLI is two commands — nothing is registered into your agent's tool list.

MIT, with real self-hosting

Alternatives are fair-code with commercial-hosting restrictions, hosted-only subscriptions, or AGPL. Pagelet is MIT on your own infrastructure: Google OAuth, an email-domain allowlist, and a bucket you control.

Built for a team, not a single seat

Reviewers get a rendered page and a comment box — no repo, no tooling, no accounts outside your allowed domains.

Run the preview locally

Install dependencies, run checks, start the app, and publish the demo report.

pnpm install --frozen-lockfile
pnpm dev

npm install -g @howtox/pagelet
pagelet publish report.html

Open-source preview

Pagelet is useful today for local demos and early self-hosted experiments. Production deployments should review auth, CSP, sandbox, storage, and deployment settings before using real data.