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>
30 lines
1.6 KiB
Markdown
30 lines
1.6 KiB
Markdown
# 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:
|
|
|
|
1. Rewire the auto-recall hook to `homelab memory recall` and the auto-learn hook
|
|
to `homelab memory store`.
|
|
2. Update the CLAUDE.md memory policy to point at the CLI.
|
|
3. 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.
|