AIppocampus MCP server

AIppocampus

<!-- mcp-name: io.github.Sapientropic/aippocampus -->

A source-backed continuity layer for long-running relationships with AI agents.

AIppocampus began with a human problem: every new agent session can be bright, capable, and strangely newborn. Work may survive in commits and notes while the path behind the work falls back into silence.

This project gives future agents a way to find that path again. It keeps source reachable, preserves the conditions of return, and lets a new conversation begin with honest continuity instead of pretending there was never a break.

Source is the ground. Summaries are weather.

First Use Path

The first useful path is deliberately narrow:

1. Install or probe the CLI.
2. Run one fuzzy recall for an old decision, handoff, preference, or thread cue.
3. Deepen that route before making claims or quoting source.
4. Use exact search only when the user remembers wording.

Install or probe:

uvx aippocampus --help
aippocampus start --json

First recall, for a fuzzy continuity cue:

aippocampus agent recall "old decision or handoff cue" --json

First deepen/source-open, using the selector from that recall:

aippocampus agent deepen --request 1 --recall-selector <emitted-selector> --json

Daily rule: if the user remembers exact wording, search source; if they remember a situation, decision, preference, old correction, or handoff, use recall first and deepen before claims.

aippocampus search "a distinctive old phrase" --json

In ordinary use, AIppocampus should feel less like a control panel than a remembered doorway. It helps an agent ask: where did this come from, what did we actually say, and which source should be opened again?

The machinery behind that moment can be extensive, but it should stay backstage. A long relationship with an AI agent should not have to start from bare ground every time a thread, device, model, or project changes.

The origin essay is 未干的地图. English readers can start with The Unfinished Map. For role-based setup, provider choices, and maintainer paths, use Start Here. For a longer first-use walkthrough, use the First Recall Decision Card or the 10-Minute Public Path. Evidence and claim boundaries live after the first route in Magic Moments, Claim-Bounded, the Can-Claim Ladder, and the Public Provenance And Current Value Ledger.

After a useful deepen, aippocampus export --json and aippocampus sync --json are carry-forward checks for the next thread, device, or project. They are not prerequisites for first recall.

AIppocampus For Coding Agents

The narrow usable product lane today is local, source-backed continuity for Codex/Claude-style long-running work: register local conversation source after consent, search or reopen old snippets, and treat recall scents or repo familiarity as navigation until source is reopened.

Start with the Coding-Agent Memory Lane when deciding whether to recommend AIppocampus as an agent-memory tool. It includes the 3-5 minute demo path, evidence drawer, and "recommend / do not recommend" boundary without duplicating the public API or readiness docs.

Agent Probe

When an AI agent needs to verify the public CLI without cloning or writing local memory artifacts, use the PyPI package and stay read-only:

uvx aippocampus --help
uvx aippocampus onboard --provider auto --status --json

Shortened. The full README is on GitHub.