BrainCTL

by tschonleber

Not rated
GitHub

About

Persistent memory for AI agents. Single SQLite file, 192 MCP tools. FTS5 search, knowledge graph, session handoffs, write gate. No server, no API keys, no LLM calls.

Details

Author
tschonleber
Categories
Productivity, AI, Other, Knowledge Base

Setup

Install BrainCTL in your MCP client (Claude Desktop, Cursor, Windsurf, and others).

Repository: https://github.com/tschonleber/brainctl

Follow the installation instructions in the repository README, then restart your MCP client.

brainctl-only baselines (Brain.search, FTS5)

LongMemEval(289-question retrieval-friendly subset oflongmemeval_s):

LongMemEval lock snapshot(old FTS-only baseline vs final locked, n=289):

LOCOMO(1,982 questions, 5 categories, 10 conversations):

LOCOMO latest retrieval operating points(n=1,982, no-LLM retrieval):

Interpretation: hybrid leads session on hit@1, hit@5, MRR, and multi-hop hit@5, ties temporal hit@5, and slightly trails on single-hop hit@5.

The Brain.search baseline remains weaker on hop-heavy categories (single-hop/multi-hop hit@1 0.167 / 0.174). Root cause: recency and salience rerankers bias toward recent memories; LOCOMO uses uniform synthetic timestamps with gold evidence concentrated in early sessions, so reranking can fight lexical evidence. A--benchmarkpreset that flattens recency/salience is available for evaluation runs.

No reviews yet — be the first

Sign in to leave a review

Use Google, GitHub, or an email account so ratings stay tied to real people.

Email sign in

No reviews posted yet.