Capsules: Context Snapshots for AI Session Handoffs

Full examples: examples.md | Reference: reference.md

Capsules are distilled context snapshots for preserving working state across sessions, tools, or agents. Not a chat log—a structured summary of what matters.

When NOT to Use Capsules

• Ephemeral debugging — Use scratch files or logs, not capsules
• Real-time state — Capsules are for handoffs, not live sync between agents
• Large data — 12K char limit; store references to files, not file contents
• Chat transcripts — Distill first; capsules are summaries, not logs
• Temporary single-session notes — Just keep them in context; no need to persist

Quick Reference