Vol. 001 Jeffs Brain·Documentation
Vol. 001 MMXXVI · Amsterdam

A memory that remembers.

jeffs-brain/memory is a cross-language memory library for LLM agents: a shared HTTP protocol and storage spec, implemented faithfully in TypeScript, Python, and Go. Local-first, hosted-optional, Apache-2.0.

Start with TypeScript Hook up MCP
Dispatches

Three SDKs, one protocol.

Pick the runtime that suits your stack. The wire, the algorithms, and the semantics are identical — enforced by a shared conformance suite and a tri-SDK eval harness.

I · npm

TypeScript

The reference implementation. CLI, library, MCP server, and Postgres / OpenFGA adapters. Drop into any Node or Bun stack.
II · go get

Go

A native Go port that mirrors the reference bit-for-bit, including every retrieval regex and the full LongMemEval replay path.
III · pip / uv

Python

Idiomatic Python API across store, query, search, retrieval, and the memory pipeline. Same CLI, same wire surface.
What's in this

The whole surface.

IV

Concepts

Brains, the five memory stages (remember, extract, reflect, consolidate, recall), the retrieval ladder, and the query DSL. Start here if you want to understand how the pieces fit.
V

MCP Integration

Stdio servers for Claude Code, Claude Desktop, Cursor, Windsurf, and Zed. Twelve memory_* tools with identical wire semantics across runtimes.
VI

CLI Reference

Every memory subcommand, flag, and exit code. Parity matrix across the three SDKs so you know what's shipped and what's stubbed.
VII

Protocol Spec

The language-neutral contract: HTTP endpoints, storage semantics, query grammar, retrieval algorithms, MCP tool cards.
VIII

LongMemEval

The cross-SDK harness that drives every SDK's daemon through the same question set. Methodology, datasets, runner.
IX

Examples

Verbatim, runnable hello-worlds in TypeScript and Go. Copy, paste, hack.