Comedy Vault

A vaudeville-styled notebook for jokes, bits, and funny moments — quick-capture napkin, star ratings, and an optional AI writer's room. Your material stays in your browser.

Every comedian knows the pain: the perfect line shows up at 1am and is gone by breakfast. Comedy Vault is the napkin that never gets lost — jot the bit down in two seconds, file it as a joke, story, observation, premise, or funny moment, and rate it by how hard the room laughed. Red curtains included.

A look inside

The napkin up top, the vault below, the curtains always drawn.

What it does

• The Napkin — quick-capture bar with type pills and a Ctrl+Enter save, because funny is perishable
• Five kinds of material — jokes, stories, observations, premises, and funny moments (with who / where / why-it-was-funny scene details)
• Audience Score ratings — from ★★★ Solid Chuckle to ★★★★★ Standing Ovation
• Tags, search, filters, and sort across your whole repertoire, plus a running stats panel
• The Writer's Room (optional, bring your own OpenAI key) — Make it Funnier, Add 3 Punchlines, Stand-up Bit, Tighten It Up, Sarcastic Rewrite, and Variations, with previous drafts kept
• The Premise Machine (also BYOK) — six prompt styles for when the page is blank and the mic is soon
• Export / import your entire vault as JSON

Quick start

Static site — no build step, nothing to install.

git clone https://github.com/Climax53/comedy-vault.git
cd comedy-vault
# it uses ES modules, so serve the folder with any static server:
python -m http.server 8080
# then open http://localhost:8080

(npx serve works too — anything that speaks HTTP. Everything still runs entirely in your browser.) The AI tools are strictly optional — add your own OpenAI API key in Settings to switch them on.

Privacy

All material lives in your browser's localStorage. Nothing is sent anywhere unless you click an AI tool, in which case that one piece of text goes straight from your browser to OpenAI using your key. The key itself never leaves your browser — and JSON exports deliberately strip it, so you can't even share it by accident. (The only other request the page makes is loading its fonts from Google Fonts; your material is never part of that.)

Built with

Plain HTML, CSS, and vanilla JavaScript (ES modules). No frameworks, no build, no dependencies.

License

MIT

---

_{Made with care as part of Reuben's little toolbox.}