Source-backed continuity

AIppocampus

A local-first memory layer for agents that need a way back to the source, not a story about having remembered.

Fastest useful path

Three steps to first recall.

Probe without writing, ask before onboarding private history, then search for one source-backed snippet.

1. Probe

Check the CLI.

Make sure the package surface is reachable before touching memory.

2. Consent

Inspect providers.

Use read-only status first; choose a provider-specific onboarding path only when allowed.

3. Search

Find source.

Use a distinctive old phrase and reopen source before strong claims.

Copy first-recall commands
uvx aippocampus --help
uvx aippocampus onboard --provider auto --status --format json
uvx aippocampus onboard --provider codex --all --format json
uvx aippocampus search "a distinctive old phrase"

Memory should be able to show where it came from.

Source first

Clean source and explicit references outrank generated summaries.

Quiet by default

Memory should surface when it helps, not turn every prompt into a personal profile.

Local first

Conversation source, registry rows, indexes, and sync bundles are private by default.

Hands holding a crystal anatomical heart lit from within.
The project keeps care and evidence in the same pair of hands.

Why it exists

Continuity is a human problem before it is an engineering one.

A bright new session can still feel strangely newborn. AIppocampus gives a future agent a way to return to the thread honestly, with the path, the source, and the limits still visible.

Common questions

Does this mean the model remembers me?

No. AIppocampus gives agents a reliable local path back to source. The model itself still has no inner autobiography of you.

Is this only for coding agents?

No. Coding agents are the cleanest pressure test, but the project is about life-wide continuity: corrections, reading notes, recurring questions, unfinished work.

Is my memory data public?

No. Public code and docs are different from private conversation source, indexes, and sync bundles, which stay on your machine unless you opt in.

When should I not use it?

Use a narrower tool if you only need a vector store, stateless RAG, or a hosted team profile. AIppocampus is heavier than a thin memory layer.