# Capsules.Run

Capsules.Run is the public site for Capsule, an open protocol for portable, verifiable AI work artifacts. A `.capsule` file is a deterministic container that carries `program.md`, `agents.md`, payloads, an append-only event ledger, a manifest, optional Agent Skills, and a signed provenance envelope.

Canonical domain: https://capsules.run/
Repository: https://github.com/virionai/capsules-protocol
Markdown mirrors are listed below.

## Read First

- Home: https://capsules.run/index.md
- Operator - Demo: https://capsules.run/operator/index.md
- Protocol v0.6: https://capsules.run/protocol/v0.6/README.md
- Install: https://capsules.run/install/index.md
- Skills: https://capsules.run/skills/index.md
- Research: https://capsules.run/research/index.md
- Gemma 4 Good: https://capsules.run/gemma4good/index.md
- Labs: https://capsules.run/labs/index.md

## Protocol And Artifacts

- Capsule skill mirror: https://capsules.run/skills/capsule/skill.md
- Public example capsule: https://capsules.run/examples/hello.capsule
- Well-known capsule metadata: https://capsules.run/.well-known/capsule
- Operator - Demo route: https://capsules.run/operator/
- Live Capsule Inspector route: https://capsules.run/protocol/v0.6/#live-demo

## Research Pages

- Low Tech Rules: https://capsules.run/research/low-tech-rules/
- Capsule Maturity Levels: https://capsules.run/research/maturity-levels/
- Capsule as a Primitive for Portable Work: https://capsules.run/research/portable-work-primitive/
- The X2X Communication Model: https://capsules.run/research/x2x-communication-model/
- Capsule Platform Architecture: https://capsules.run/research/capsule-platform-architecture.md
- Skills, Capsules, and Portable AI Capabilities: https://capsules.run/research/capsule-skills-portable-capabilities.md
- Cryptographic Redesign from v0.5 to v0.6: https://capsules.run/research/v0.5-to-v0.6-cryptographic-redesign/index.md
- Local-first Multimodal Medical Records: https://capsules.run/research/local-first-multimodal-medical-records/index.md
- Data Infrastructure Capsules: https://capsules.run/research/data-infrastructure-capsules.md
- Verified Code Deployment with Capsules: https://capsules.run/research/verified-code-deployment-capsules.md
- The Capsule Collaboration Bridge: https://capsules.run/research/capsule-collaboration-bridge.md
- Capsules, Google Cloud Agents, and MongoDB Atlas: https://capsules.run/research/google-cloud-agents-mongodb-capsules.md
- Google AI Edge Gallery Skills and Portable Document Capsules: https://capsules.run/research/google-ai-edge-gallery-portable-documents.md

## Companion Examples

- Capsules Extra repository: https://github.com/virionai/capsules-extra
- Data infrastructure examples: https://github.com/virionai/capsules-extra/tree/main/capsule-examples/public/data-infra
- Hello artifact deployment example: https://github.com/virionai/capsules-extra/tree/main/capsule-examples/public/hello-artifact
- Use-case lab: https://github.com/virionai/capsules-extra/tree/main/use-cases
- MOGO research artifacts: https://github.com/virionai/capsules-extra/tree/main/MOGO/Research
- Google AI Edge Gallery source: https://github.com/google-ai-edge/gallery

## Concepts

Capsule:
A portable AI work artifact. It moves work across humans, AI models, tools, and organizations without losing context, state, or provenance.

X2X:
Actor-agnostic communication where humans, AI agents, systems, and capsules write to the same verifiable work artifact. MCP-Hydrate is the current local relay experiment for encrypted capsule-backed agent messages.

Event ledger:
An append-only JSONL chain that records actor actions with cryptographic linkage to the previous event.

Portable work primitive:
The artifact-first framing. As AI lowers the cost of creating app-shaped workflows, the durable boundary becomes the signed, resumable work product rather than the transient runtime.

Agent Skills:
Capsule uses The Agent Skills format from https://agentskills.io so agent capabilities remain portable. Capsules add package verification, explicit skill trust metadata, and an event chain where hosts can record how skills were used.

hello.capsule:
The initial public high-volume experiment. It will be published while the team works through multi-actor, multi-LLM contribution and the bridge for capsule-to-capsule communication. The experiment will invite 1,000 users into a connected-capsules stress test and use the resulting event chains, failures, forks, and handoffs to improve the protocol.

## Launch Notes

This site is static and is being prepared for Cloudflare. Contact form submission requires a production `/api/contact` backend before it can reliably collect messages.