// readme

zbrain

zbrain is a Rust-native CLI for local-first trusted memory and workspace-isolated agent context.

The shipped runtime keeps canonical OKF-style Markdown claims and immutable local evidence snapshots, builds a disposable SQLite FTS5 index, and returns trusted context JSON. It does not call an LLM or model provider.

MIT license Β· Contributing Β· Changelog

Features

  • Workspace-isolated memory rooted at ~/.zbrain/ or ZBRAIN_HOME.
  • OKF-style claim concepts in the axioms, mental-models, projects, and decisions tiers.
  • Explicit claim lifecycle: draft -> approved -> superseded|revoked.
  • Immutable local evidence snapshots with origin, capture time, media type, byte length, and SHA-256 metadata.
  • Rebuildable per-workspace SQLite FTS5 lexical indexes.
  • Fail-closed trusted retrieval with visible ready, gap, and blocked outcomes.
  • status and doctor diagnostics for index and embedding configuration.
  • Optional local hybrid retrieval through ask --embed; lexical…