---
title: "hosti: a self-hosted home for my AI agents' HTML reports"
description: 'My agents explain their work as HTML pages. Then they moved to Discord and I moved to my phone, and a file on my PC stopped being enough.'
pubDate: 'October 4, 2026'
tags: ['AI', 'Side Projects']
draft: false
---

[hosti](https://hosti.kubaszwajka.com) is a small self-hosted catalog for the HTML pages my agents make. It's MIT and it's [on GitHub](https://github.com/JakubSzwajka/hosti).

## Why I made it

When an agent plans a change, digs into a bug or compares two ways to build something, I ask it for an HTML page. Diagrams, a table, a short "why", the risky parts marked. I read that way faster than a wall of text in a terminal.

The agents from [the box and the loop](/blog/how-i-build-small-products-autonomously-hetzner-swarm-and-agent-loops) pick up specced items, open PRs and report to me on Discord. The agent writes `report.html` on my PC and posts "done, see report.html". Great, thanks. I'm not at my desk, and the Discord message is just a path.

## How it works

The agent pushes a bundle, a folder with an `index.html`. One command:

```bash
$ hosti push ./report --slug flaky-tests --title "Flaky tests"
pushed   revision 1
private  nothing answers at the share URL
admin    https://hosti.example.com/b/flaky-tests
```

The last line is the owner link. The agent drops it in Discord, I tap it, and the page opens because I'm logged in to hosti. Wherever I am. Toilet included. For anyone without my login that link is a dead end. If the agent pushes the same slug again, it's a new revision behind the same link, so I just reload.

<figure class="diagram">
<svg class="dgm-wide" viewBox="0 30 700 172" role="img" aria-label="The trip a page takes: the agent finishes a task and runs hosti push, the bundle lands private in hosti, the agent posts the owner link in Discord, and I tap it on my phone where I am logged in.">
<defs>
<marker id="hw-arrow" viewBox="0 0 10 10" refX="9" refY="5" markerWidth="8" markerHeight="8" orient="auto-start-reverse">
<path d="M0,1 L9,5 L0,9 z" fill="var(--green)"/>
</marker>
</defs>
<rect class="node" x="6" y="70" width="132" height="90" rx="2"/>
<text class="lbl" x="22" y="98">agent</text>
<text class="sub" x="22" y="120">done with a task</text>
<text class="sub" x="22" y="136">wrote index.html</text>
<rect class="node-green" x="196" y="70" width="132" height="90" rx="2"/>
<text class="lbl" x="212" y="98">hosti</text>
<path class="icon" d="M214,114 V110 a3,3 0 0 1 6,0 V114"/>
<rect class="icon-fill" x="212" y="114" width="10" height="8" rx="1"/>
<text class="sub-green" x="228" y="122">private</text>
<text class="sub" x="212" y="142">/b/flaky-tests</text>
<rect class="node" x="386" y="70" width="132" height="90" rx="2"/>
<text class="lbl" x="402" y="98">Discord</text>
<text class="sub" x="402" y="120">&quot;done, here:&quot;</text>
<text class="sub-green" x="402" y="136">the owner link</text>
<rect class="node" x="598" y="40" width="96" height="150" rx="14"/>
<rect class="chip" x="632" y="47" width="28" height="4" rx="2"/>
<rect class="node-green" x="606" y="58" width="80" height="122" rx="3"/>
<text class="lbl-sm" x="646" y="92" text-anchor="middle">me</text>
<text class="sub" x="646" y="110" text-anchor="middle">logged in</text>
<text class="sub-green" x="646" y="128" text-anchor="middle">reading</text>
<rect class="chip" x="618" y="142" width="56" height="4" rx="2"/>
<rect class="chip" x="618" y="152" width="44" height="4" rx="2"/>
<rect class="chip" x="618" y="162" width="52" height="4" rx="2"/>
<path class="edge-green" marker-end="url(#hw-arrow)" d="M138,115 H196"/>
<path class="edge-green" marker-end="url(#hw-arrow)" d="M328,115 H386"/>
<path class="edge-green" marker-end="url(#hw-arrow)" d="M518,115 H598"/>
<text class="elabel" x="167" y="104" text-anchor="middle">push</text>
<text class="elabel" x="357" y="104" text-anchor="middle">link</text>
<text class="elabel" x="558" y="104" text-anchor="middle">tap</text>
<g class="packet" opacity="0"><rect x="-5" y="-6" width="10" height="12" rx="1"/><animateMotion dur="6s" repeatCount="indefinite" path="M140,115 H186" keyPoints="0;0;1;1" keyTimes="0;0.08;0.22;1" calcMode="linear"/><animate attributeName="opacity" dur="6s" repeatCount="indefinite" values="0;1;0" keyTimes="0;0.08;0.22" calcMode="discrete"/></g>
<g class="packet" opacity="0"><rect x="-5" y="-6" width="10" height="12" rx="1"/><animateMotion dur="6s" repeatCount="indefinite" path="M330,115 H376" keyPoints="0;0;1;1" keyTimes="0;0.4;0.54;1" calcMode="linear"/><animate attributeName="opacity" dur="6s" repeatCount="indefinite" values="0;1;0" keyTimes="0;0.4;0.54" calcMode="discrete"/></g>
<g class="packet" opacity="0"><rect x="-5" y="-6" width="10" height="12" rx="1"/><animateMotion dur="6s" repeatCount="indefinite" path="M520,115 H588" keyPoints="0;0;1;1" keyTimes="0;0.7;0.86;1" calcMode="linear"/><animate attributeName="opacity" dur="6s" repeatCount="indefinite" values="0;1;0" keyTimes="0;0.7;0.86" calcMode="discrete"/></g>
</svg>
<svg class="dgm-tall" viewBox="0 0 340 514" role="img" aria-label="The trip a page takes: the agent finishes a task and runs hosti push, the bundle lands private in hosti, the agent posts the owner link in Discord, and I tap it on my phone where I am logged in.">
<defs>
<marker id="ht-arrow" viewBox="0 0 10 10" refX="9" refY="5" markerWidth="8" markerHeight="8" orient="auto-start-reverse">
<path d="M0,1 L9,5 L0,9 z" fill="var(--green)"/>
</marker>
</defs>
<rect class="node" x="20" y="10" width="300" height="64" rx="2"/>
<text class="lbl" x="36" y="36">agent</text>
<text class="sub" x="36" y="58">done with a task, wrote index.html</text>
<rect class="node-green" x="20" y="118" width="300" height="64" rx="2"/>
<text class="lbl" x="36" y="144">hosti</text>
<path class="icon" d="M38,160 V156 a3,3 0 0 1 6,0 V160"/>
<rect class="icon-fill" x="36" y="160" width="10" height="8" rx="1"/>
<text class="sub-green" x="52" y="168">private</text>
<text class="sub" x="304" y="168" text-anchor="end">/b/flaky-tests</text>
<rect class="node" x="20" y="226" width="300" height="64" rx="2"/>
<text class="lbl" x="36" y="252">Discord</text>
<text class="sub" x="36" y="274">&quot;done, here:&quot;</text>
<text class="sub-green" x="160" y="274">the owner link</text>
<rect class="node" x="110" y="334" width="120" height="170" rx="14"/>
<rect class="chip" x="156" y="341" width="28" height="4" rx="2"/>
<rect class="node-green" x="118" y="352" width="104" height="140" rx="3"/>
<text class="lbl-sm" x="170" y="388" text-anchor="middle">me</text>
<text class="sub" x="170" y="406" text-anchor="middle">logged in</text>
<text class="sub-green" x="170" y="424" text-anchor="middle">reading</text>
<rect class="chip" x="134" y="444" width="72" height="4" rx="2"/>
<rect class="chip" x="134" y="456" width="56" height="4" rx="2"/>
<rect class="chip" x="134" y="468" width="66" height="4" rx="2"/>
<path class="edge-green" marker-end="url(#ht-arrow)" d="M170,74 V118"/>
<path class="edge-green" marker-end="url(#ht-arrow)" d="M170,182 V226"/>
<path class="edge-green" marker-end="url(#ht-arrow)" d="M170,290 V334"/>
<text class="elabel" x="184" y="100">push</text>
<text class="elabel" x="184" y="208">link</text>
<text class="elabel" x="184" y="316">tap</text>
<g class="packet" opacity="0"><rect x="-5" y="-6" width="10" height="12" rx="1"/><animateMotion dur="6s" repeatCount="indefinite" path="M170,77 V108" keyPoints="0;0;1;1" keyTimes="0;0.08;0.22;1" calcMode="linear"/><animate attributeName="opacity" dur="6s" repeatCount="indefinite" values="0;1;0" keyTimes="0;0.08;0.22" calcMode="discrete"/></g>
<g class="packet" opacity="0"><rect x="-5" y="-6" width="10" height="12" rx="1"/><animateMotion dur="6s" repeatCount="indefinite" path="M170,185 V216" keyPoints="0;0;1;1" keyTimes="0;0.4;0.54;1" calcMode="linear"/><animate attributeName="opacity" dur="6s" repeatCount="indefinite" values="0;1;0" keyTimes="0;0.4;0.54" calcMode="discrete"/></g>
<g class="packet" opacity="0"><rect x="-5" y="-6" width="10" height="12" rx="1"/><animateMotion dur="6s" repeatCount="indefinite" path="M170,293 V324" keyPoints="0;0;1;1" keyTimes="0;0.7;0.86;1" calcMode="linear"/><animate attributeName="opacity" dur="6s" repeatCount="indefinite" values="0;1;0" keyTimes="0;0.7;0.86" calcMode="discrete"/></g>
</svg>
<figcaption>The trip a page takes now.</figcaption>
</figure>

<video src="/blog-images/self-hosted-html-reports-for-ai-agents/phone-clip.mp4" autoplay muted loop playsinline width="320" style="display:block;margin-inline:auto" aria-label="On a phone: the hosti catalog, a tap on the flaky tests card, its bundle page, then the report itself scrolling."></video>

## Goodies

- **Sharing, only when I ask.** I hate it when a teammate drops a copy-pasted thread from their Claude chat into Slack. I don't want to be that guy. Still, sometimes an idea I worked out with an agent is worth showing someone, so I share the page. A link or a PIN, and `hosti rotate` if a link went further than I meant.
- **Live cards.** Every bundle in the catalog is a card, and the card is the real page in a sandboxed iframe, not a screenshot. I find "that thing from last week" by how it looks.
- **The agent never gets my password.** It runs `hosti login`, I check the code it prints and approve. It can delete only if I tick that box myself.
- **A skill.** `npx skills add JakubSzwajka/hosti` and the agent knows how to push, when to share, and to hand me the link exactly as printed.

![The hosti catalog: every bundle is a card with its live page inside, marked pin, link or private.](/blog-images/self-hosted-html-reports-for-ai-agents/catalog-grid.webp)

Everything else is in [the README](https://github.com/JakubSzwajka/hosti#readme).

One rough edge. My agents sometimes make a new slug when they should push a new revision, so I get a second link for the same report. I haven't taught them to prefer a revision yet.

Anyway. The landing page is [hosti.kubaszwajka.com](https://hosti.kubaszwajka.com) and the code is [on GitHub](https://github.com/JakubSzwajka/hosti). Ping me if you try it, or if your agents also keep sending you paths to files on a machine you're not sitting at.