Truth

Local-first OKF agent memory. Markdown is truth; SQLite is the search index.

GitHub PyPI Full docs

pip install truth-memory
truth skill install
truth index
truth serve

Architecture

notes/*.md ──► agent (memory_write) ──► log.md ▲ │ │ ▼ └── watcher ──► indexer ──► memory.db (SQLite) │ memory_search ◄───┘

Agent tools

memory_search — hybrid vector + BM25 (RRF), optional type/tags filters
memory_write — OKF markdown with YAML frontmatter + changelog
memory_delete — remove notes; index rows dropped eagerly

Stack

Python 3.11+ · sqlite-vec · sentence-transformers (local PyTorch)
watchdog file watcher · MCP stdio server for Cursor / Claude Code