Skip to content

Quickstart

Add memory in two commands.

hippo is an MIT-licensed npm package with zero runtime dependencies. Install it, point it at your home directory, and it wires itself into the agents you already use.

Install

$ npm install -g hippo-memory
$ hippo init --scan ~

init --scan ~ detects your agents, installs their hooks, and gives you memory across every git repo under your home directory. Everything lives in a local SQLite store with markdown mirrors. No cloud, no account, no telemetry.

Works with your agents

Claude Code Auto-installs a recall hook on session start and a sleep hook on exit.
Cursor Hook on task start plus the MCP server for in-editor recall.
Codex Auto-installed hook via hippo init.
OpenClaw Skill that injects recall on start and runs sleep on session end.
OpenCode Hook installed by hippo init.
Any MCP client MCP server for Cursor, Windsurf, Cline, and Claude Desktop.

The memory loop

Four commands. Memories decay on a half-life unless something keeps them alive: a retrieval, a good outcome, an error tag, or consolidation during sleep.

$ hippo remember "deploy failed: forgot migrations" --error Store a memory. Errors get a longer half-life and stick.
$ hippo recall "why did the deploy break" --budget 2000 Retrieve within a token budget, ranked by relevance and strength.
$ hippo outcome --good Tell hippo the recall helped. Useful memories decay slower.
$ hippo sleep Consolidate repeats into patterns, decay the unused, flag conflicts.