Repolode
Submit
kitfunso

kitfunso/hippo-memory

Long-term memory for coding agents that stores memories in a local SQLite database and shares them across Claude Code, Codex, Cursor and other MCP clients.

View on GitHubWebsite
Stars
784
Forks
46
Open issues
29
Last commit
5 hours ago

What is it?

Hippo gives coding agents a persistent memory that survives between sessions and between tools. Memories are kept in a SQLite store on your machine, with markdown mirrors that can be read and committed to git. Recall uses BM25 keyword search by default, with no model download or network call; embeddings are an optional install.

Unlike systems that save everything and search later, Hippo adjusts memory strength over time. Memories decay with a configurable half-life, recalled memories are reinforced, errors decay more slowly, and outcomes marked good or bad raise or lower a memory's ranking. Running hippo sleep consolidates related episodes into merged memories and removes duplicates.

`hippo init` installs hooks for Claude Code and OpenCode, adds hook entries for Codex when it is installed, and adds instructions to AGENTS.md or CLAUDE.md. Any MCP client can connect. The project also imports from ChatGPT exports, CLAUDE.md, .cursorrules and markdown, and can ingest Slack and GitHub events through an HTTP API.

Key features

  • 01Local SQLite store with markdown mirrors that can be committed to git
  • 02BM25 search by default, with no model or network call required
  • 03Memory decay, reinforcement on recall, and outcome feedback for ranking
  • 04Hooks for Claude Code and OpenCode, plus Codex and AGENTS.md integration
  • 05MCP server and HTTP API for any compatible client
  • 06Imports from ChatGPT exports, CLAUDE.md, Cursor rules and markdown

Use cases

  • Keeping lessons from past bugs available when switching between Claude Code, Cursor and Codex
  • Storing project conventions and decisions in a reviewable, git-tracked form
  • Keeping proprietary project memory on your own machine instead of a hosted service
  • Importing existing CLAUDE.md or Cursor rules into a shared store

Quick start

  1. 1

    Install the package globally with npm

    npm install -g hippo-memory
  2. 2

    In a project, run init to create its store and wire in your agents

    hippo init

Things to know

  • Automatic capture on every agent needs extra setup and host trust, such as trusting Codex hooks in /hooks.
  • Sleep sends memory text to Anthropic for fact extraction when ANTHROPIC_API_KEY is set, unless extraction is disabled in config.
  • Embeddings are optional and need a separate install; search works with BM25 by default.
  • Requires Node.js 22.16 or newer.

Topics

#agent-memory#coding-agent#mcp#sqlite#local-first#llm-memory#claude-code#cursor#ai-agents#ai-memory

FAQ

What is hippo-memory?
Long-term memory for coding agents that stores memories in a local SQLite database and shares them across Claude Code, Codex, Cursor and other MCP clients. Hippo gives coding agents a persistent memory that survives between sessions and between tools. Memories are kept in a SQLite store on your machine, with markdown mirrors that can be read and committed to git. Recall uses BM25 keyword search by default, with no model download or network call; embeddings are an optional install.
Is hippo-memory free to use? What license does it have?
hippo-memory is open source under the MIT license. Check the license terms before using it in commercial products.
Is hippo-memory still maintained?
Actively maintained. The last commit to hippo-memory was on Oct 22, 2026.
What can I use hippo-memory for?
Keeping lessons from past bugs available when switching between Claude Code, Cursor and Codex Storing project conventions and decisions in a reviewable, git-tracked form Keeping proprietary project memory on your own machine instead of a hosted service Importing existing CLAUDE.md or Cursor rules into a shared store
How do I install hippo-memory?
Install the package globally with npm: npm install -g hippo-memory In a project, run init to create its store and wire in your agents: hippo init
Where can I get hippo-memory?
The source code and installation instructions are on GitHub: https://github.com/kitfunso/hippo-memory

Summary generated by AI from the project's README. GitHub stats refresh daily.

Related projects