Claude-Mem
github.com/thedotmack/claude-mem- Category
- AI Agents
- Rank
- No. 38Tools index
- Listed in
- #1 Give an agent memory
- Pricing
- Open Source
- Type
- TOOL
- Builder
- thedotmack
- GitHub
- 93.4k stars
- Latest release
- v13.24.1
- Date
About
A Claude Code plugin that automatically preserves context across coding sessions by capturing tool usage, compressing it with AI, and injecting relevant context back into future sessions. Enables Claude to maintain continuity of knowledge about projects even after sessions end.
What it does
Claude-Mem builds a searchable project history around AI coding sessions. Lifecycle integrations record tool results and assistant messages, while a local worker stores observations, summaries, and prompts. Later, assistants can retrieve a compact result index, inspect nearby chronology, then fetch detailed observations only when needed. A browser viewer exposes the live feed, settings, logs, project filters, and older records.
Why it's ranked here
The design goes beyond a simple transcript archive. It combines automatic collection, structured storage, natural-language search, chronological retrieval, citations, and a viewer for inspecting what was retained. Progressive disclosure is especially sensible because it lets an assistant narrow results before loading expensive detail. The broad integration surface is useful, but the worker, AI provider, storage, hooks, and optional server runtime create meaningful operational weight.
What's good
Search follows a disciplined staged workflow: find compact references, inspect their surrounding timeline, then batch-fetch full observations. Users can exclude sensitive material with private tags and tune injected context. The viewer merges live and paginated records, filters by project, exposes queue state, and includes settings and logs. Installation supports interactive and non-interactive provider, model, runtime, and IDE selection.
Tradeoffs
This is a service-backed system, not a passive note file. The normal runtime requires Bun, while installation requires a recent Node version. Correct installation matters because a global npm install provides only the library and does not register hooks or configure the worker. Automatic telemetry is enabled by default but can be disabled. Stored context can still contain sensitive project activity unless users apply privacy controls deliberately.
How to use it well
Use it for long-running projects where coding assistants repeatedly revisit earlier decisions, fixes, and tool output. Let automatic capture handle routine continuity, then use staged search when a question needs evidence from older sessions. Check the viewer periodically, tune context injection, and mark sensitive passages private. It does not replace source control, issue tracking, documentation, backups, or a general team knowledge base.
Technical notes+
package.json defines an ESM npm package, requires Node 20.12 or newer and Bun 1.0 or newer, exposes a command-line binary, and runs tests with Bun. src/npx-cli/index.ts dispatches installation, repair, lifecycle, diagnostics, telemetry, search, server, transcript, and integration commands. src/cli/adapters/index.ts selects adapters for Claude Code, Codex, Cursor, Windsurf, Antigravity, and raw input. src/integrations/opencode-plugin/index.ts posts session activity to worker HTTP endpoints and exposes memory search inside OpenCode. src/services/server/Server.ts implements Express health, readiness, version, instruction, restart, and shutdown routes. src/storage/sqlite/index.ts and src/storage/postgres/index.ts expose local and server-oriented storage layers. src/ui/viewer/App.tsx combines server-sent live updates with paginated history and project filtering. src/supervisor/index.ts validates worker ownership through PID data, removes stale records, manages health checks, and coordinates shutdown.
Observed
- License
- Apache-2.0
- Primary language
- TypeScript, with React TSX for the viewer
- Packaging
- ES module npm package with a command-line binary and exported plugin modes
- Install surface
- npx installer or Claude Code plugin marketplace commands; global npm installation provides the library only
- Interfaces
- CLI, lifecycle hooks, MCP search tools, local HTTP API, OpenCode plugin, and web viewer
- Runtime requirements
- Node.js 20.12 or newer and Bun 1.0 or newer
- Storage
- SQLite modules for local data and PostgreSQL repositories for server storage
- Integration surface
- Adapters include Claude Code, Codex, Cursor, Windsurf, Antigravity, and raw input; the CLI also lists additional IDE identifiers
Read from README.md, package.json, src/npx-cli/index.ts, src/supervisor/index.ts, src/ui/viewer/App.tsx, src/ui/viewer/index.tsx, src/cli/adapters/index.ts, src/cli/handlers/index.ts, src/storage/sqlite/index.ts, src/services/server/Server.ts, src/storage/postgres/index.ts, src/npx-cli/commands/server.ts, src/services/transcripts/cli.ts, src/services/infrastructure/index.ts, src/integrations/opencode-plugin/index.ts.
What it can do
Capture tool usage observations during coding sessions
Claude's tool interactions and code activities → Recorded session data and tool usage logs
Compress session context using AI
Raw tool usage observations and session data → Semantic summaries of coding activities
Inject relevant context into new coding sessions
Current session queries and stored memory summaries → Contextually relevant information from previous sessions
Generate semantic summaries of coding activities
Tool usage patterns and code interactions → Compressed semantic representations of work done
Maintain persistent memory across session boundaries
Session summaries and project information → Continuously updated project knowledge base
Preserve project continuity knowledge
Multi-session coding work and context → Maintained understanding of project state and history
Tags
Tech Stack
Media
Comments (0)
No comments yet
Editorially curated, with community endorsements as a secondary signal. Corrections welcome.