Horatius Docs
Concepts

Capsules

The building blocks of your knowledge, individual pieces of saved context.

A capsule is a single piece of saved context. It can be a solution, a decision, a code snippet, a prompt template, or anything else worth reusing.

Reference IDs

Every capsule gets a human-friendly reference ID scoped to your account and its Type, like @docker/3 or @decisions/12. These IDs are unique within your account for a given Type, so your @docker/3 is independent of another user's. You can use references to link capsules together, building a connected knowledge base without copy-pasting.

Structure

Each capsule contains:

  • Title: a short, descriptive name
  • Content: markdown-formatted body with the actual knowledge
  • Type: the category it belongs to (e.g., Solutions, Decisions)
  • Summary: an optional short description for search results
  • Attachments: files, screenshots, or logs (optional)

Creating Capsules

You can create capsules in two ways:

  1. Via MCP: ask your AI assistant to save context directly: "Save this as a Solution"
  2. Via Web UI: use the Horatius dashboard to create and edit capsules manually

See Create Your First Capsule for a step-by-step walkthrough.

On this page