rohitg00 /agentmemory
#1 Persistent memory for AI coding agents based on real-world benchmarks
★ 30,381⑂ 2,699👁 80⑃ 1,051● 713▤ 55
+21
日增长
+266
周增长
+1,094
月增长
30,381
stars
2,699
forks
80
watchers
1,051
prs
713
issues
55
releases
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 recTop issues
#195Architecture: Prevent Event Loop Freezes Caused by Heavy CPU-bound Tasks.9 comments · 2026-04-23#1360Oversized store fields and unpaginated full-list endpoints: sourceSessionIds/sourceMemoryIds bloat + 16 MiB WS frame limit7 comments · 2026-09-10#1238`GRAPH_EXTRACTION_ENABLED=false` does not stop graph writes - structural extraction runs unconditionally on session stop7 comments · 2026-08-22#716Resolve project identity from canonical repo URL, not directory basename7 comments · 2026-05-29#1058OpenClaw plugin: agent_end observe broken (missing project/cwd, raw-path project, zombie active sessions)6 comments · 2026-07-14#1378Worker heartbeat death loop on large legacy graph corpus: any vector result triggers blocking expandFromChunks (plus DROP_STALE_INDEX full-rebuild variant)5 comments · 2026-09-18#1264Test suite: 30 failures on Windows, all test-side platform assumptions5 comments · 2026-08-27#510Bug: MCP tools not loaded by Claude Code despite healthy server and working plugin5 comments · 2026-05-18
Discussions
#1616Jcode Integration1 comments · 2026-10-26#1358Running agentmemory without the iii engine4 comments · 2026-09-09#1246Independent Windows-native AgentMemory downstream for Codex (source preview)1 comments · 2026-08-25#1102RR ❤️ agentmemory: one of the repos that split memory from RAG1 comments · 2026-07-23#1071Is this project abandoned?1 comments · 2026-07-17#980Curated knowledge ingestion and large session summarization2 comments · 2026-06-26#901Setting up AgentMemory on a remote server as centralized memory service3 comments · 2026-06-11#865Hooks for gemini?2 comments · 2026-06-09
Latest release
v0.9.33 v0.9.33 2026-11-09Drop-in upgrade on iii 0.25.1. Docker installs that set only an LLM key: add AGENTMEMORY_LLM_PROVIDER (see Changed). Added - Stores above 64 MiB keep working: whole-scope reads page, transport cap raised to 64 MiB (1636, 1634) - Session list filters startedAfter, startedBefore, endedAfter, endedBefore (1527) - AGENTMEMORY_SUMMARY_TIMEOUT_MS for large sessions on slow or local LLMs (1689) - memory_diagnose / memory_heal find and remove orphaned facets (1698) Fixed - Search no longer caps saved memories at three per query (1696); evicted memories leave the indexes (1601) - Boot detects gaps