Home/AI Agents/claude-mem
claude-mem logo

claude-mem

thedotmack/claude-mem

Persistent Context Across Sessions for Every Agent

GraphCanon updated 1d · GitHub synced 1d

91k stars8.0k forksLast push 1d JavaScript Apache-2.0

Decision brief

claude-mem provides persistent context across sessions, leveraging AI to capture and compress agent activity.

Good fit when

  • When you require seamless and persistent context continuity between different session interactions with Claude Code or other supported agents.
  • If your development workflow needs long-term memory capabilities for code history and project context recall.

Avoid when

  • When working in environments where Node.js v20.0.0 or higher cannot be installed, as claude-mem requires this version to operate.
  • If your specific AI agent or tool does not integrate with the supported frameworks listed (e.g., Claude Code, OpenClaw), making context persistence ineffective for your workflow.
Requirements:
Requires Node.js v20.0.0 or higher.; Must have the latest version of Claude Code with plugin support.; Auto-installs Bun (JavaScript runtime and process manager) if not already present.; Requires uv (Python package for vector search), auto-installation supported.

Observed Jul 11, 2026 · Source: enrich:decision_facts

Verify the decision

Adoption

Package downloads where a registry match exists. GitHub stars (91,018) are secondary evidence.

npm downloads (30d)
63,660·npm downloads API·1d

Maintenance and security

Full trust report
Maintenance
Very active (0d since push)
As of 1d
Provenance
Not a fork · Personal account
As of 1d
Security (OSV)
No lockfile
As of 1mo

Public GitHub metadata and optional OSV scans. Signals, not a guarantee. Trust methodology.

Install

npm install claude-mem
npm

How it fits your stack(24)

Typed graph edges - alternatives, integrations, successors, and dependencies. Ranked by relationship type, not raw GitHub stars.

Integrates

Relationship graph

Optional deeper exploration of typed edges and category neighbours.

Similar tools

Same-category neighbours not already linked as typed edges.

Evidence and technical details

Sourced facts, taxonomy, compatibility claims, README excerpt, and machine-readable endpoints.

Overview

Captures agent activity during sessions, compresses it with AI, and injects relevant context into future sessions.

Capability facts

Deploy
Self-host

Source: dockerfile:docker-compose.yml · Aug 18, 2026

Docker
Dockerfile present

Source: dockerfile:docker-compose.yml · Aug 18, 2026

CLI
CLI entrypoint

Source: package.json:bin|scripts · Aug 18, 2026

MCP server
Ships MCP server

Source: package.json:@modelcontextprotocol/* · Aug 18, 2026

Languages
javascript, typescript

Source: github.language+package.json · Aug 18, 2026

Categories

Graph entities

Compatibility

Sourced claims from the README excerpt - not unsourced marketing copy.

Node.js runtimeNode.js

Source: README excerpt (regex_v1, Aug 18, 2026)

- **Node.js**: 20.0.0 or higher
Source link
Python runtimePython

Source: README excerpt (regex_v1, Aug 18, 2026)

- **uv**: Python package manager for vector search (auto-installed if missing)
Source link

Tags

README

Quick Start

Install with a single command:

npx claude-mem install

Or install for OpenCode:

npx claude-mem install --ide opencode

Or install for Antigravity CLI (setup guide):

npx claude-mem install --ide antigravity

Or install from the plugin marketplace inside Claude Code:

/plugin marketplace add thedotmack/claude-mem

/plugin install claude-mem

Restart Claude Code. Context from previous sessions will automatically appear in new sessions.

Note: Claude-Mem is also published on npm, but npm install -g claude-mem installs the SDK/library only — it does not register the plugin hooks or set up the worker service. Always install via npx claude-mem install or the /plugin commands above.


Getting Started

  • Installation Guide - Quick start & advanced installation
  • Usage Guide - How Claude-Mem works automatically
  • Search Tools - Query your project history with natural language
  • Cloud Sync - Back up your memories to cmem.ai — no daemon, the worker syncs on write

System Requirements

  • Node.js: 20.0.0 or higher
  • Claude Code: Latest version with plugin support
  • Bun: JavaScript runtime and process manager (auto-installed if missing)
  • uv: Python package manager for vector search (auto-installed if missing)
  • SQLite 3: For persistent storage (bundled)


License

Claude-Mem is licensed under the Apache License 2.0.

We chose Apache-2.0 because durable agentic memory should be easy to embed in developer tools, local agents, MCP servers, enterprise systems, robotics stacks, and production agent harnesses.

See the LICENSE file for full details. See docs/license.md and docs/ip-boundary.md for licensing scope and the open/commercial boundary.

Note on Ragtime: The ragtime/ directory is licensed under the Apache License 2.0. See ragtime/LICENSE for details.


For agents

This page has a .md twin and JSON over the API.

Was this helpful?

Anonymous feedback helps us improve pages and translations.