48b63ffa6f
Lets agents search/navigate memory via the CLI, as the first step toward deprecating the memory MCP. claude-memory is a FastAPI service (the MCP is just one frontend); homelab memory is a thin Bearer-auth HTTP client over the same API, using the env the hooks already set (CLAUDE_MEMORY_API_URL/KEY). It works even when the MCP frontend is down — the recurring disconnect that took the MCP offline for this whole session. Verbs: recall (server-side semantic search), list, categories, tags, stats, secret (read); store, update, delete (write). Validated against the live API including a store→recall→delete round-trip — full data-plane parity with the MCP. The deprecation itself (rewiring the per-prompt auto-recall + auto-learn hooks to the CLI, then uninstalling the MCP) is a deliberate follow-up, sequenced after the CLI is proven in the hooks — see docs/adr/0008. Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
1.6 KiB
homelab memory verb-group: direct HTTP client to claude-memory; MCP deprecation path
v0.3 adds the memory verb-group so agents can search and navigate memory from the
CLI. claude-memory is a FastAPI service (Postgres-backed, Bearer-auth,
ingress auth = "none" so programmatic clients work) — the MCP is just one
frontend over it. homelab memory is a thin HTTP client over the same API,
using the env the hooks already set (CLAUDE_MEMORY_API_URL +
CLAUDE_MEMORY_API_KEY; defaults to the ingress). Because it talks to the HTTP
API directly, it works even when the MCP frontend is down — the recurring
MCP-disconnect problem that motivated claude-memory HA (and that took the MCP
offline for the entire session this was built in).
Verbs: recall (server-side semantic ranking), list, categories, tags,
stats, secret (read); store, update, delete (write). Validated against
the live API including a store→recall→delete round-trip — full data-plane parity
with the MCP.
Deprecation path (deliberate follow-up — NOT done in v0.3)
The MCP is more than tools: the per-prompt auto-recall hook and the auto-learn hook run on every prompt for every agent. Deprecating it safely is a separate, sequenced change:
- Rewire the auto-recall hook to
homelab memory recalland the auto-learn hook tohomelab memory store. - Update the CLAUDE.md memory policy to point at the CLI.
- Uninstall the MCP.
Done CLI-first (verbs proven before touching the every-prompt path) so a regression can't silently break auto-recall/auto-learn fleet-wide.