# Capsules.Run

Canonical page: https://capsules.run/

Capsule is an open protocol for portable AI work artifacts. A `.capsule` file carries content, machine-readable state, and a verifiable event ledger so work can move across tools, teams, models, and time.

## What A Capsule Contains

- `surface.md`: the human-readable work product.
- `state.json`: the current operational snapshot, including open tasks, progress, and resumption context.
- `chain/events.jsonl`: an append-only event ledger that records who did what and when.
- `manifest.json`: protocol metadata, plans, capabilities, embedded skills, and verification rules.

## Core Idea

Traditional systems scatter work across documents, databases, apps, emails, and human memory. Capsules consolidate that context into one transferable artifact. Any actor can open it, validate it, continue the work, and hand it off.

## Runtime Model

Capsules can run anywhere an actor can read the protocol:

- Install the Capsule skill into an Agent Skills-compatible harness.
- Use the Capsule MCP server in an MCP-compatible client.
- Drop a `.capsule` file into an LLM with the universal runtime prompt.

## Current Public Artifacts

- Operator - Demo: `/operator/`
- Live Capsule Inspector: `/protocol/v0.6/#live-demo`
- Protocol spec lane: `/protocol/v0.6/`
- Capsule skill mirror: `/skills/capsule/skill.md`
- Public example capsule: `/examples/hello.capsule`
- LLM site map: `/llms.txt`

## Key Pages

- [Operator - Demo](/operator/index.md): local-first media/file intake, interaction, command briefing, and signed capsule transport.
- [Protocol spec](/protocol/v0.6/README.md): v0.6 format docs, hydration order, and live capsule inspector.
- [Install guide](/install/index.md): bootstrap prompt, distribution lanes, and harness install paths.
- [Skills registry](/skills/index.md): capsule and pith skills for agents.
- [Pith skill](/skills/pith/index.md): causal compression grammar for event chains and prose.
- [Research hub](/research/index.md): papers, concepts, and protocol questions.
- [Capsule Maturity Levels](/research/maturity-levels/index.md): the continuity-of-work scale.
- [Low Tech Rules](/research/low-tech-rules/index.md): local LLMs, protocols, and less stack.
- [Capsule Labs](/labs/index.md): domain experiments and workflow hypotheses.
- [Start an experiment](/labs/contact/index.md): contact surface for proposing a lab.