wadachi

Welcome to the wadachi wiki

Wadachi (轍, wa-da-chi — the tracks wheels leave in a road) is a persistent, local-first memory server for AI agents, spoken over MCP. Your sessions leave tracks; future sessions follow them.

This wiki covers everything: how the brain works, every one of the 31 tools, every CLI command, every safety mechanism, and the honest answers in the FAQ — the honest answers.

Meta-note: this wiki is itself built the way wadachi's brain is built — markdown files with wikilinks, compiled to plain HTML. What you're reading practices what it preaches.

What wadachi is, in one paragraph

Most memory tools store and search. Wadachi's brain behaves like one: memories are Beliefs, staleness & decay that can go stale and be superseded; Decisions remember why and what was rejected; a typed The typed knowledge graph connects everything; it can Provenance & time-travel to what it believed at any date; and it periodically "sleeps" — proposing consolidations that you approve. All of it local, in plain markdown you own, with zero telemetry.

The four rules

Everything in wadachi follows four design rules:

  1. Local-first, privacy-first. No telemetry, no cloud calls, no exceptions.
  2. Memories are sacred. Nothing is ever lost or silently rewritten — versioning, migrations with backups, export/restore.
  3. Propose, never auto-edit. The software suggests; the human decides.
  4. Degrade gracefully. Everything works (or fails helpfully) without optional deps.

Where to start

Installation →