Skip to content

Chill-AI-Space/instant-publish

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

9 Commits
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

instant-publish

Turn any 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.

Supported formats

Format Browser AI access (?raw)
.md / .markdown Rendered as clean HTML with GitHub-style typography Raw markdown
.txt Monospace text Raw text
.html Served as-is

Markdown is the recommended format for text-heavy content. AI agents can access the raw source instantly via ?raw — no HTML parsing needed.

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

Usage

# Publish markdown (recommended)
npx instant-publish deploy report.md --slug quarterly-report
# → Published: https://chillai.space/p/quarterly-report?password=A1b2C3dE
# → Raw (for AI): https://chillai.space/p/quarterly-report?password=A1b2C3dE&raw

# Publish HTML (self-contained, inline CSS)
npx instant-publish deploy page.html --slug landing-page

# Publish plain text
npx instant-publish deploy notes.txt --slug meeting-notes

# Republish (preserves password)
npx instant-publish deploy report-v2.md --slug quarterly-report --password A1b2C3dE

# List your pages
npx instant-publish list

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

# Open portal — admin dashboard to browse, preview, and manage all your pages
npx instant-publish portal

Raw access for AI agents

When you publish .md or .txt files, the raw source is stored alongside the rendered HTML. AI agents can read it by appending &raw to the URL:

https://chillai.space/p/my-doc?password=xxx&raw

This returns plain text/markdown or text/plain — no HTML wrapper, no parsing needed. Content negotiation also works: requests with Accept: text/markdown or Accept: text/plain headers get raw source automatically.

How it works

  • Content is stored on Cloudflare R2 (edge-cached globally)
  • Pages are password-protected by default (SHA-256 hashed)
  • Markdown is rendered to HTML at deploy time (via marked), raw source stored separately
  • Republishing preserves the password — existing links keep working
  • Pages are served at https://chillai.space/p/<slug>
  • Portal at https://chillai.space/portal?key=YOUR_API_KEY — admin dashboard to browse, preview, and manage all your published pages
  • 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

About

Turn any document into a shareable link on chillai.space

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors