hippo-memory
One memory for every agent you'll ever use. Hippo writes what you teach a coding agent into a store in your repo, and your other agents read that same store.
What is hippo-memory?
One memory for every agent you'll ever use. Hippo writes what you teach a coding agent into a store in your repo, and your other agents read that same store.
Overview of hippo-memory
What it is
Hippo is long-term memory for coding agents. It stores memories in a SQLite database on the user's machine, with markdown mirrors that can be read and committed. It connects across different tools such as Cursor, Claude Code, and Codex. It keeps proprietary data completely local and learns over time by strengthening memories each time they are recalled, letting mistakes decay. It has zero runtime dependencies and requires Node.js 22.16+.
Key features
- Stores memories in a SQLite backbone with markdown mirrors that are git-trackable and human-readable.
- Search uses BM25 out of the box with no model and no network call; embeddings are an optional install.
- Mark a memory wrong and it ranks lower; run
hippo supersedeand the old fact leaves recall. - Works with Claude Code, Codex, Cursor, OpenClaw, OpenCode, Pi, and any MCP client.
- Imports from ChatGPT, Claude (CLAUDE.md), Cursor (.cursorrules), Slack, and markdown.
- Has zero runtime dependencies; optional embeddings can use local Transformers.js or opt-in API embedders (OpenAI/Voyage/Cohere).
Use cases
- Preventing an agent from repeating past mistakes by storing error memories with a longer half-life.
- Surviving tool switches: using Claude Code on Monday, Cursor on Tuesday, and Codex on Wednesday, all reading the same
.hippo/store. - Ingesting systems of record such as Slack and GitHub via webhooks, with full provenance and GDPR-correct deletion.
- Multi-tenant setups where API keys are scrypt-hashed and an audit log tracks every mutation; tenant A cannot see tenant B's memories.
Getting started
bashnpm install -g hippo-memory && hippo initAfter installation, run hippo init inside a project to create the project's .hippo/ store and add a block to the existing CLAUDE.md or AGENTS.md. The init command also adds hooks for agents it finds and a daily 6:15am run. For complete setup instructions, see the repository README.
License and pricing
License: MIT. Pricing type: open source.
Based on the project's public README and repository metadata.