Why agents forget, what the cabinet actually is, the surfaces you operate, the tools your agents call, and the path to agent‑ready. Five stages, read in order.
Every fresh session, your agent rebuilds context from scratch — re-reading, re-deciding, re-asking. Grounded exists to end the tax.
No black box, no managed service. ~/Grounded/Cabinet is a directory on disk you can open, diff, back up, and move; settings sit apart in ~/.grounded. Self-hosted continuity means the substrate is yours.
Durable rules and decisions, pinned to outrank drift. The operator's truth — captured, not inferred.
POST /facts What changed and why, captured in order. The momentum record between one sitting and the next.
POST /sessions The indexed source of record. Living documentation that reflects reality, kept searchable.
POST /docs/ingest Hybrid search over all three, merged with reciprocal rank fusion. Returns small, cited, ranked cards.
POST /recall The assembled working set, agent-ready. Wakes any agent up already holding the work — and your vision for it.
POST /brief Grounded exposes MCP tools that wire into the agents you already run. Each call returns small cited cards first; the full record only when the task asks for it.
On Windows, Grounded Companion installs it for you. On macOS and Linux, the install script and grounded install run it under Docker or systemd — cabinet at ~/.grounded.
Through the console or POST /facts, pin durable truth that recall ranks first.
Point your MCP client at the server. Every agent now wakes to cited recall.