| name | memory |
| description | Project memory powered by Hippo. Use when starting a session, after learning something, after hitting an error, or when the user mentions memory/remember/recall. Auto-invoked at session start. |
Hippo Memory
This project uses Hippo for biologically-inspired memory across sessions.
Memories decay over time unless retrieved. Errors stick longer. Sleep consolidates.
At session start (MANDATORY)
Before doing any work, load relevant context:
hippo context --auto --budget 1500
Read the output. These are things the project has learned from past sessions.
When you learn something non-obvious
hippo remember "<the lesson in 1-2 sentences>" --tag <category>
When you hit an error or unexpected failure
hippo remember "<what failed, why, and how you fixed it>" --error
The --error flag doubles the half-life. Hard lessons don't fade quietly.
After completing work successfully
hippo outcome --good
If the recalled memories were irrelevant:
hippo outcome --bad
When stuck or hitting repeated errors
hippo recall "<what's going wrong>" --budget 2000 --why
When making an architectural decision
hippo decide "<decision>" --context "<why>"
Decisions get a 90-day half-life and a recall boost so they surface when relevant.
When migrating or replacing a tool
hippo invalidate "<old tool>" --reason "migrated to <new tool>"
Or let hippo learn --git detect it automatically from migration commits.
After significant coding sessions
hippo learn --git
This scans recent commits, auto-extracts lessons, and invalidates memories about replaced tools.
Export memories
hippo export memories.json
hippo export --format markdown memories.md
Check memory health
hippo status
