Horatius Docs

Create Your First Capsule

Save your first piece of context to Horatius.

Via MCP (AI Conversation)

The easiest way to create a capsule is directly from an AI conversation. Just ask:

"Save this as a Solution in Horatius"

Your AI assistant will use the MCP tools to create the capsule, applying the type's guidance to structure the content appropriately.

Via the Web UI

  1. Navigate to your Library at /library
  2. Click New Capsule
  3. Select a Type (or create a new one)
  4. Write your content using Markdown
  5. Save

Understanding References

Every capsule gets a reference ID scoped to its type and your account. For example, if you create a capsule under the "Docker" type, it might get the reference @docker/1.

You can use these references in other capsules to compose rich context:

I solved a similar problem in @docker/1, but this time the issue was
with volume permissions rather than networking.

What to Save

Good candidates for capsules:

  • Solutions: Fixes to problems you might encounter again
  • Decisions: Technical decisions with reasoning and trade-offs
  • Prompts: Reusable AI instructions you want to run repeatedly
  • Snippets: Code patterns you use across projects
  • Processes: Step-by-step workflows for recurring tasks

On this page