Empirical Docs / Getting Started

Empirical overview.

Empirical is a durable memory layer for AI tools. Capture context once, then recall relevant context across coding agents, chat clients, and MCP integrations.

What Empirical is

Empirical stores durable memory (preferences, decisions, project context) and exposes it through MCP and API surfaces so different tools can share the same context source.

How memory flows

Capture context, scope it, and query it at execution time. Retrieval is relevance-ranked so the most useful context reaches the active tool.

  • Capture: notes, project decisions, durable preferences
  • Scope: personal vs workspace/project boundaries
  • Recall: query before coding or response generation

Recommended start path

Install the CLI, complete OAuth, connect your local tools, then validate with doctor and one sample memory query.

empirical install
empirical oauth bootstrap headless --write-env
empirical doctor

Boundary: Empirical stores durable context; it is not a replacement for source control, a transcript archive, or a general-purpose database.

Last updated: May 21, 2026