v0.2.0 - first public release
Local-first long-term memory for AI agents: a plain Markdown vault + a thin MCP server.
Highlights
- 6 MCP tools: memory_query / memory_ingest / memory_lint / memory_distill / memory_profile / memory_suggest
- 3 MCP resources: agentbrain://rules, agentbrain://index, agentbrain://profile
- CLI: init / query / ingest / lint / distill / profile / suggest / apply / index / path / serve
- Vault: plain Markdown, Obsidian-friendly, Git-friendly; Index.md as cheap retrieval layer 1
- Retrieval: CJK-aware BM25 (Chinese works out of the box), boosted by verified/use_count/recency
- Self-maintenance: lint writes human-approved merge proposals; apply executes them transactionally; distill promotes recurring patterns
- Profile layer: agents read owner preferences and propose changes via suggestions - never edit directly
- 44 passing tests; compatible with both mcp 1.x and 2.x SDKs
Install
pip install git+https://github.com/2672243194/agentbrain.git@v0.2.0
Requires Python >= 3.10.