instant-publish

Turn any HTML document into a shareable link on chillai.space.

Your AI generates a report, a page, a document — instant-publish gives it a permanent URL in one command. No hosting setup, no deploy pipeline. Just a link.

Setup

npx instant-publish init

This does three things:

1. Generates your API key
2. Registers it with chillai.space
3. Adds instructions to Claude Code so it knows how to publish automatically

After this, when you ask Claude Code to create an HTML document, it will publish it via instant-publish and give you the link.

Usage

# Publish a file (first time — generates a password)
npx instant-publish deploy report.html --slug my-report
# → Published: https://chillai.space/p/my-report?password=A1b2C3dE

# Update the same page (password is preserved)
npx instant-publish deploy report-v2.html --slug my-report
# → Updated: https://chillai.space/p/my-report (password unchanged)

# Update with a new password
npx instant-publish deploy report-v2.html --slug my-report --new-password
# → Published: https://chillai.space/p/my-report?password=X9y8Z7wV

# List your pages
npx instant-publish list

# Delete a page
npx instant-publish delete my-report

How it works

• HTML is stored on Cloudflare R2 (edge-cached globally)
• Pages are password-protected by default (SHA-256 hashed, never stored in plaintext)
• Republishing preserves the password — existing links keep working
• Pages are served at https://chillai.space/p/<slug>
• API key lives in ~/.config/instant-publish/config.json
• No database, no accounts — just a key and your content

Why not PDF?

PDF takes 12 seconds to generate. HTML takes 0.4 seconds. PDF needs a viewer. HTML needs a browser you already have open. PDF is an email attachment. HTML is a link.

Read the full investigation

License

MIT