memhooks 0.5.0

Backend-neutral parser, resolver, validator, and CLI for filesystem-scoped AI agent memory routing
Documentation
# MemHooks documentation

MemHooks is a filesystem-scoped, **backend-neutral retrieval-routing protocol** for AI agents. These guides cover the `memhooks/v2` protocol, Rust reference implementation, runtime integration, and provider adapter mappings.

## Start here

- [Quickstart]quickstart.md — enable MemHooks and understand what happens automatically.
- [CLI reference]cli.md — `memhooks validate` and `memhooks explain`.
- [Rust library guide]rust-library.md — call the reference parser/resolver directly from Rust.
- [Agent integration guide]integrating-an-agent.md — wire MemHooks into an agent runtime/harness.
- [Protocol guide]protocol-guide.md — practical `memhooks/v2` core and backend namespace semantics.
- [Troubleshooting]troubleshooting.md — validator diagnostics and common failure modes.
- [Publishing the Rust crate]publishing.md — maintainer notes for crates.io releases.

## Who maintains hook files?

Ordinary users normally **do not** hand-maintain `MEMHOOKS.md`.

The normal division is:

1. the user enables MemHooks and optionally configures a memory backend;
2. the agent/runtime creates and updates local retrieval cues;
3. the reference resolver validates/merges those cues;
4. the active memory adapter performs retrieval.

Operational advice about keeping cues concise, pruning stale routing, and choosing provider hints is therefore documented in the agent/runtime material rather than presented as a user chore.

## Canonical specification

The normative format contract is [`references/memhooks-format.md`](../references/memhooks-format.md). If an explanatory guide conflicts with the format reference, the format reference wins.

## Provider mappings

Provider-native vocabulary lives only inside provider namespaces:

- [Hindsight]../references/memory-systems/01-hindsight.md — `backends.hindsight`
- [OpenViking]../references/memory-systems/02-openviking.md — `backends.openviking`
- [Honcho]../references/memory-systems/03-honcho.md — `backends.honcho`
- [Mem0]../references/memory-systems/04-mem0.md — `backends.mem0`
- [Generic / unknown backend]../references/memory-systems/99-generic-or-unknown.md

## Runtime-specific documentation

- [Hermes / Hermes Desktop integration]../hooks/hermes/README.md

## Design boundary

MemHooks does **not** become a memory database, lowest-common-denominator provider API, shell-command manifest, prompt-privilege system, or daemon.

The core answers:

> **What should the agent remember here?**

Provider namespaces answer:

> **How should this particular memory backend help retrieve it?**

The host runtime still owns memory access, credentials, trust policy, execution, prompt construction, and context-budget enforcement.