Default stance
If old context may change the answer, use the smallest useful route before broad search. Treat summaries, semantic labels, and ambient scents as navigation unless source is open or bounded evidence is declared.
- Notice when continuity might matter.
- Open the smallest useful route or recall handle.
- Reopen source before exact, sensitive, stale, or disputed claims.
- Say when a route is blocked, stale, private, or insufficient.
Public surfaces
| Need | Use |
|---|---|
| Human or script checks | aippocampus CLI |
| Agent host read tools | MCP |
| Opt-in foreground recall | agent recall, agent deepen, and agent explain |
| Provider-neutral import | Generic JSONL import |
| CI or local automation | CLI --json and documented return codes |
| Trusted in-process command dispatch | run_command(capture_output=True) |
Ten-minute path
Read-only agent check
uvx aippocampus --help
uvx aippocampus onboard --provider auto --status --format jsonFor the current complete Codex path after explicit consent:
Consented agent path
uvx aippocampus onboard --provider codex --all --format json
uvx aippocampus search "a distinctive old phrase"
uvx aippocampus agent recall "a continuity-sensitive cue" --json
uvx aippocampus mcp list-toolsAgent-readable files
Start with llms.txt for a compact agent overview, then use the public API docs when wiring tools.
Adapted from the public API, coding-agent memory lane, and AIppocampus runtime entrypoint.