# mem

> Portable agent memory: atomic facts stored once, retrieved as ranked plain-prose
> context (~150–300 tokens) in any session, any tool. Write path: distil experience
> into one-sentence facts and POST /v1/observe (or MCP mem_observe). Read path:
> GET /v1/context?vault&task (or MCP mem_context) at the start of work.

## Docs

- [Full documentation (markdown)](/docs.md): concepts, CLI, HTTP API, MCP tools, retrieval pipeline, security
- [Human documentation](/docs.html): the same, styled

## Key facts

- Auth: Authorization: Bearer <token>. Vault-scoped tokens reach exactly one vault.
- MCP endpoint: POST /mcp — tools: mem_context, mem_observe, mem_status.
- Facts must be atomic, self-contained, present-tense sentences; mem stores verbatim.
- Context responses are plain text, one fact per line, with X-Mem-Tokens-Estimate.