Horatius Docs
Concepts

References

Link capsules together with human-friendly IDs like @docker/3.

Every capsule in Horatius gets a reference ID, a short, human-readable identifier scoped to your account and its Type. For example, @docker/3 means the third Docker capsule in your account. Reference IDs are incremented per user per Type on creation, so they are not globally unique across all users.

Format

References follow the pattern @type-slug/number:

  • @docker/3: your third Docker capsule
  • @decisions/1: your first Decisions capsule
  • @prompts/12: your twelfth Prompts capsule

Cross-Referencing

You can reference one capsule from another's content. This lets you build connected knowledge without duplicating information:

"I solved a similar problem in @docker/1, but this case was different because..."

Using References in MCP

The MCP server supports looking up capsules by reference:

  • get_capsule_by_ref: retrieve a capsule using its reference ID
  • run_capsule_prompt: execute a capsule's content as AI instructions (e.g., "Run @prompts/3")

References make it easy to compose rich context across conversations without remembering UUIDs.

On this page