README

Persistent memory across coding sessions and agents.
  
  Persistent memory for Claude Code, GitHub Copilot CLI, Cursor, Gemini CLI, Codex CLI, Hermes, OpenClaw, pi, Oh My Pi, OpenCode, DeepSeek Harness, and any MCP client.



  🇬🇧 English •
  🇨🇳 简体中文 •
  🇹🇼 繁體中文 •
  🇯🇵 日本語 •
  🇰🇷 한국어 •
  🇵🇹 Português •
  🇧🇷 Português (Brasil) •
  🇪🇸 Español •
  🇩🇪 Deutsch •
  🇫🇷 Français •
  🇮🇹 Italiano •
  🇳🇱 Nederlands •
  🇵🇱 Polski •
  🇨🇿 Čeština •
  🇷🇴 Română •
  🇭🇺 Magyar •
  🇬🇷 Ελληνικά •
  🇸🇪 Svenska •
  🇩🇰 Dansk •
  🇳🇴 Norsk •
  🇫🇮 Suomi •
  🇷🇺 Русский •
  🇺🇦 Українська •
  🇹🇷 Türkçe •
  🇮🇱 עברית •
  🇸🇦 العربية •
  🇮🇳 हिन्दी •
  🇧🇩 বাংলা •
  🇵🇰 اردو •
  🇹🇭 ไทย •
  🇻🇳 Tiếng Việt •
  🇮🇩 Bahasa Indonesia •
  🇵🇭 Tagalog



  



  



  The gist extends Karpathy's LLM Wiki pattern with confidence scoring, lifecycle, knowledge graphs, and hybrid search: agentmemory is the implementation.



  
  
  
  
  



  
  
  
  



  
    
  



  Install •
  Quick Start •
  Benchmarks •
  vs Competitors •
  Agents •
  How It Works •
  MCP •
  Viewer •
  Config •
  API


---

AgentMemory captures coding sessions, makes decisions and fixes searchable, and lets your agents recall them later. Keep one memory store across tools, inspect what was saved, and choose how much context reaches the model.

- Capture: native hooks and plugins record supported session events, with secret scrubbing and offline replay.
- Recall: keyword search works without an API key; local or remote embeddings add semantic search.
- Continue: retrieve project history, lessons and session handoffs from another agent.
- Inspect: browse, edit, export and forget memories in the live viewer.

 Install

Requirements:

- Node.js 20 or newer with npm and npx (node -v, npm -v, and npx -v).
- macOS/Linux also need curl, a POSIX sh, and tar for automatic runtime setup.
- Windows users can use WSL2 or follow the native Windows setup.

Start setup:

bash
npx -y @agentmemory/agentmemory@latest


Choose your agents and either a provider or keyless mode. Setup writes the configuration, starts the memory server, and offers a global install for the agentmemory command. -y accepts the npm package prompt; @latest selects the current release. LLM-written observation compression is opt-in with a provider and AGENTMEMORY_AUTO_COMPRESS=true.

Keyless mode disables vector embeddings. memory_recall (the mem::search path) uses BM25, while memory_smart_search can also fuse structural graph matches when graph data already exists. For free on-device semantic recall, set EMBEDDING_PROVIDER=local in ~/.agentmemory/.env and restart. The first embedding request downloads Xenova/all-MiniLM-L6-v2; inference runs locally after that initial model download.

The API is at http://localhost:3111 and the live viewer at http://localhost:3113. Both bind to loopback by default. Configuration lives in ~/.agentmemory/.env; see data storage for memory locations and separate instances.

Then prove rec