I've tried everything else. Chat windows close. Canvases mutate. Share links rot. Markdown loses structure. Notion locks you in. PDFs lose interactivity. A Capsule is what I save now: one sealed HTML file, structured and readable, ready to share, archive, or re-read years from now. Five use cases below; two commitments make them last.
Use case 01 · The origin
Save the parts of an AI conversation worth keeping.
You start a new chat in ChatGPT. You ask some questions, it answers. The conversation meanders, one topic linking to another, but you finish feeling like you got something of value out of it. Then what? You close the tab. Where does the info go? Into your chat history. Ready to pollute the next conversation you didn't want it to. What if you want to share it with someone? You ask for a summary. But in what format? PDF? Markdown? Just text and screenshots? What about HTML? I guess you could share a "link," but something about that seems brittle…
A Capsule is what you save. Manifest with provenance (which model, what date, what conversation source). Data block with the structured content: decisions, sources, conclusions, open questions. Rendered HTML that reads on its own without the runtime. Integrity hash that proves the bytes haven't drifted.
One file. Drop it in a folder, attach it to email, hand it to someone who can continue the work. The model behind the conversation can change; the platform can disappear; the share link can break. The file still opens.
Use case 02 · File over app
Notes that outgrew markdown.
You're deep in Obsidian. Vault built, plugins humming, daily-notes template dialed in. Then a note grows up. It wants to embed a chart. It wants a manifest the next reader can interrogate. It wants to be shareable to someone who doesn't have your vault. Markdown doesn't carry those. You can hand-write HTML inside the markdown, but then it doesn't render right in half the viewers, and you start fighting your own format.
A Capsule is what notes become when they reach that point. The plain text is still there, rendered into the HTML at build time, readable in any browser. On top: structured fields the runtime can use. A decision table the reader can sort. References that copy as citations. Exports that produce JSON for downstream tools. An "about" panel showing where this came from.
The file is still one document; it opens like a webpage; it survives a copy / paste / email / share without dropping any of the structure. If you're already in the file-over-app school (Obsidian, Tana, plain markdown notes in a git repo), a Capsule is what an individual note becomes when it deserves more rigor than markdown can give it.
Use case 03 · Time-bounded snapshots
Capture a moment of work without a database.
You're three weeks into something. The state of what you know on Tuesday morning is the version that matters. It's what you took to the meeting, what the team agreed on, what you signed off on. By Friday it'll already be different. The property dossier just before LOI. The research conclusion at week three. The bug investigation right before the fix shipped. You want this moment, frozen, citable later. You could put it in Notion, but Notion will quietly change underneath you. You could put it in a doc, but the doc keeps editing itself the moment anyone else gets access.
A Capsule packages it: structured data in a JSON block, human-readable rendering, provenance metadata, an integrity hash. No schema migrations, because the data block belongs to this snapshot. If next month's snapshot has a different shape, it's a different capsule. No database to maintain. No live query that might return different results tomorrow.
The cost is what a snapshot always costs: it doesn't auto-update. The benefit is what a snapshot always gives: it stays exactly the way it was when you sealed it.
Use case 04 · Offline, portable, self-contained
An app that runs from a thumb drive.
You want to give your sister the family photos. Not a Google Drive link she'll lose. Not an iCloud share that requires her to have an iCloud account. Not a USB stick of raw JPEGs she'll have to figure out how to open. You want one file she can double-click. It opens like a tiny website. The photos are arranged, the captions are visible, the dates and locations are there if she wants them. No internet needed. No installation. The same shape works for a reference manual that has to run in airplane mode, a self-contained calculator, a small DAW with bundled stems and live mixing.
Capsules at tier 4 (the top of the interactivity stack) are full apps. They just happen to be apps that fit in a single HTML file with their data baked in. Open one in 2026 or 2035; if the browser engine still renders HTML and runs JavaScript, the app works. No backend, no API to maintain, no DLC to download.
The trade-off is the size budget (everything's inline, so the file is bigger than a typical webpage) and the lack of live data (it's a snapshot, not a service). Those are the same trade-offs PDFs make. Capsules just make them for richer content.
Use case 05 · Discovery + collaboration
Share with a domain-aware registry.
You're not making something for one recipient. You're making something other people in your same line of work — the same domain, the same conversations — should be able to find. A regular link drops it in a sea of regular links. You want this file to land somewhere your peers will see it, discuss it, fork it, attest its integrity hash when it loads. That's the job of a registry, and the format works with one without depending on one.
A registry like MinDev hosts capsules from people working in geological exploration. Each capsule keeps its integrity hash. Each gets a stable URL. Each can be discussed in conversations attached to it.
The format is hosting-agnostic. The same Capsule works on any host, on a thumb drive, in your email. Hosts add discovery and discussion; they don't change what the file IS. The host-vs-format split is documented in the hosting pattern for anyone building a registry in their own domain.
Common questions
What people ask first.
What is a Capsule?
A Capsule is one sealed HTML file with five inline blocks: a manifest (identity, provenance, integrity hash), a data block (the snapshot, as JSON), styles, the rendered content, and an optional runtime. No external dependencies. No network requests. No companion folders or sidecar files. The same envelope shape whether an LLM, a build script, or a human authored it.
Open it in any browser, on any device, decades from now. A profile of HTML, not a new file format. See the twelve rules in CAPSULE_CORE.md.
Isn't that like an Artifact?
Claude's Artifacts, ChatGPT's Canvas, Gemini's Canvas. These are working canvases. The text streams in, the code re-renders, you and the model iterate side by side until something works. A Capsule isn't a working canvas; it's what one becomes when the iteration stops and the result is worth keeping.
Working canvases are great for making. Capsules are for keeping. You finish iterating in a Canvas; you emit a Capsule to share, archive, or hand off. The platform's Artifact may evolve, get versioned silently, or expire with the chat; the Capsule you sealed out of it doesn't. The seal step comes after the canvas step.
Why not Markdown?
Markdown is great. We're not anti-markdown. But markdown has no manifest, no integrity hash, no embedded media, no structured data block, no declared capabilities, no runtime. Markdown is content with formatting; a Capsule is content plus structure plus provenance plus interactivity, packaged in one HTML file.
If you're in the file-over-app school, a Capsule is what a note becomes when it deserves more rigor than markdown can give it. And many capsule data blocks ARE compiled from markdown source.
Why not a notes app?
Notion, Obsidian, Tana, Apple Notes. Those are working surfaces. You edit, link, restructure, iterate, leave things half-done. A Capsule isn't a working surface; it's a sealed output. Same complementary relationship as an AI canvas above. The two layers complement; they don't compete.
You probably use both. Edit in your notes app of choice; emit a Capsule when something in there is finished enough to share or preserve, with provenance and integrity your notes app didn't carry. The Capsule is what one of your notes becomes when it leaves the editing layer for good.
Why not a database?
A database is for live, queryable, mutable data: what's true now. A Capsule is for a frozen snapshot: what was true then. The cost: it doesn't auto-update. The benefit: no schema migrations, no server to maintain, no live query that might return different results tomorrow, no account required to read it.
Use a database when you need the live state. Use a Capsule when you want to share or preserve a moment.
Why not a PDF?
PDFs were the previous answer to "portable finished work." They're closed, lossy, and not machine-readable. A Capsule gives the same role (portable, archive-able, single file) to HTML, which is open, programmable, re-readable, and inspectable.
PDFs are great for print fidelity. Capsules are great for screen-native, machine-readable, re-rendered, interactive content. Both serve "seal this and send it." Just for different content shapes.
Different problems, different formats. A Capsule is the answer when you want structured, durable, single-file, AI-readable. Any one of those is what makes it different from any one alternative.
Why a Capsule lasts
Two commitments that make every use case above durable.
A minimum floor.
Even if JavaScript doesn't run (iOS QuickLook, email preview, screen reader, ten-year-old browser), the substance is in the HTML. The runtime is enhancement, not requirement. Apps when alive. Documents when dormant.
See the five tiers of capsule interactivity →A sealed boundary.
A Capsule's substance lives in the file. No network fetches. No live data. No external dependencies. If a "Capsule" depends on a server somewhere, it's not a Capsule. It's a web app or a live dashboard, which is a different category of artifact entirely.
See the capsule boundary →Together: the boundary makes the floor possible; the floor is what makes a Capsule honest about what it can promise.
Closing
That's why I save my work as HTML now.
Not the only format I use. The one I trust to still open.
The one that doesn't ask me to remember which platform I was on, which app the file came from, which login I'd need to recover, which CDN I'd need to be alive, which subscription I'd need to be paying.
A Capsule is a small bet that the substrate stays open. Years from now, when I want to remember what I knew on a Tuesday in 2026 — the chat I had with the model that's no longer being served, the property dossier from the deal that fell through, the family photos I almost lost when the cloud went sideways — I want the file to just open.
That's the whole project.
What this is not
Four lines of fence-posting.
- Not an app pretending to be a document. A document that can wake up into an app.
- Not a standard you have to comply with. A loose discipline.
- Not anti-platform. Anti-context-loss.
- Not finished. Active research.
Go deeper
Three ways to read the project.
What I do with all the HTML I get from AI
First-person account of why this discipline exists. From copy-pasting between AI tools, through the Obsidian / plugin shelf, to landing on HTML as the substrate worth writing a contract for.
Read essay → Long-form explorationObservations · questions · answers
The full editorial walk-through with sourced quotes (Karpathy, Thariq, Kepano, htmlbin, html-docs, Workplane). Five observations, three questions, nine answers. Where the framing got worked out before this landing got stripped down.
Read the exploration → Research logF1 — F28 · methodology and findings
The empirical-pressure-driven spec evolution: what was investigated, what was observed, what was spec-changed in response. Includes producer-population reads, host-vs-registry distinction, the genre-tension resolution, and the upstream-feedback-discipline pattern.
Read the log →Other versions
Different angles on the same project.
HTML you can keep — the v1 landing
The previous direction of this page. "Anti-context-loss" eyebrow, the lifecycle pills strip (Substrate · Live edit · Seal · Host · Discover), the anatomy card showing the five inline blocks. Preserved at /v1 with an archived-notice banner while v2 took a use-case and essay shape.
View v1 → Essay · summaryFile over app. Master edition.
Short summary essay (3 min) on the PKM Bell Curve meme applied to capsules. HTML at both ends of the curve, but the right-edge HTML is informed by the long detour through Obsidian / Notion / Tana / MCP / agent frameworks. Companion piece to the maintainer's journey notes.
Read the essay →About this page
This page is itself a Capsule per Core v0.3.0. Five required blocks, all inline. No network, no analytics. v2 — forked from the original landing sketch; v0.3.0 applies the HTML Capsule design system.
Loading manifest…