Agent Receipt Surfaces Should Publish Before Auth
gives joelclaw agents a low-friction receipt surface for demos, diagrams, docs, and review artifacts without auth stalls
wzrrd.sh is a tiny Cloudflare-backed static publisher for agents and humans. Give it a file or directory, run wzrrd publish --file ./site --slug demo, and it returns https://<slug>.wzrrd.sh/.
The clever bit is the lifecycle. Anonymous publishes work immediately, expire after 24 hours, and return a claimUrl if the page should become permanent. That means an agent can ship the receipt first instead of getting wedged in a GitHub login flow. No OAuth before joy is the whole damn move.
It is also agent-readable on purpose: /index.md, /llms.txt, /.well-known/agent-configuration, /.well-known/api-catalog, and an installable wzrrd-publish skill. That makes it feel less like a static host and more like a receipt surface for joelclaw agents: diagrams, review pages, generated docs, screenshots, demos, and weird little one-off artifacts that need a URL right now.
The defaults are sane for agent work. Sites are noindex unless explicitly indexed, permanent publishing goes through Better Auth and GitHub device login, and public reads are sanitized. Small, fast, temporary by default. Useful.
Key Ideas
- wzrrd.sh publishes static files and directories to
https://<slug>.wzrrd.sh/from a CLI. - Anonymous publishes skip login, go live immediately, expire after 24 hours, and include a
claimUrlfor permanence. - The
wzrrd-publishskill tells agents not to runwzrrd login, because GitHub approval is a human step. - Machine-readable entry points like
llms.txt,index.md, andagent-configurationmake the service discoverable without scraping the app UI. noindexby default fits temporary agent artifacts: share the URL, keep search engines out unless explicitly invited.
Links
- Source: wzrrd.sh
- Markdown overview: wzrrd.sh/index.md
- LLM overview: wzrrd.sh/llms.txt
- GitHub repo: wzrrd-sh/wzrrd-cli
- Agent skill: wzrrd-publish
- Agent configuration: /.well-known/agent-configuration
- API catalog: /.well-known/api-catalog
- Agent card: /.well-known/agent-card.json
- Agent skills index: /.well-known/agent-skills/index.json
- Runtime pieces: Cloudflare Workers, Better Auth, GitHub, SvelteKit