# Ormah

> The quiet, self-maintaining memory layer your agents can share—private, portable, and yours.

Ormah gives agents durable context without making memory another tool they must
remember to call. It learns what matters from use and feedback, whispers a
relevant memory when the current context calls for it, and stays silent when it
has nothing useful to add.

Memory has always been yours. Ormah helps keep it that way.

Core behaviours:

- Proactive whispering before the agent has to search.
- Calibrated silence when no memory applies.
- Relevance that learns, stale context that fades, and maintenance that
  consolidates memory over time.
- Shared continuity across supported agents.
- Human-readable Markdown source memory, stored locally and controlled by the
  user.

For the complete product briefing, use
[llms-full.txt](https://www.ormah.me/llms-full.txt).

## Start here

- [Quickstart](https://www.ormah.me/docs/getting-started/quickstart): Install
  Ormah, verify the local service, and remember and recall a first memory.
- [Supported agents](https://www.ormah.me/docs/integrations/supported-agents):
  Current first-class integrations and other connection paths.
- [Overview](https://www.ormah.me/docs/how-ormah-works/overview): The
  local-first memory model and core runtime concepts.

## Install and integrate

- [Installation](https://www.ormah.me/docs/getting-started/installation):
  Desktop, CLI, plugin, and troubleshooting paths.
- [MCP and adapters](https://www.ormah.me/docs/integrations/mcp-and-adapters):
  MCP tools plus CLI, HTTP, and OpenAI-style adapter architecture.
- [Custom agents](https://www.ormah.me/docs/integrations/custom-agents):
  Connect a tool-calling agent using OpenAI-format tool schemas.
- [HTTP API](https://www.ormah.me/docs/integrations/http-api): Direct access to
  the local FastAPI service.

## How memory works

- [Whisper](https://www.ormah.me/docs/how-ormah-works/whisper): Proactive,
  selective context injection for supported client hooks.
- [Search and ranking](https://www.ormah.me/docs/how-ormah-works/search-and-ranking):
  How semantic, lexical, recency, importance, and feedback signals work together.
- [Background jobs](https://www.ormah.me/docs/how-ormah-works/background-jobs):
  Relationships, conflicts, duplicate handling, and maintenance.
- [Storage layer](https://www.ormah.me/docs/how-ormah-works/storage-layer):
  Markdown-backed source memory and derived local indexes.

## Reference

- [API surface](https://www.ormah.me/docs/reference/api-surface): Public API,
  agent tools, and admin operations.
- [Configuration reference](https://www.ormah.me/docs/operations/configuration-reference):
  Environment variables, paths, and runtime configuration.

## Optional

- [Source repository](https://github.com/r-spade/ormah)
- [All desktop releases](https://github.com/r-spade/ormah/releases)
- [Discord community](https://discord.gg/guBU6XweBu)