claudekit / tools / claude-mem
[ Plugin · Claude Code Utilities ]

Claude-Mem

Persistent memory compression system built for Claude Code. Context survives across sessions by capturing tool observations and generating semantic summaries.

thedotmack/claude-mem ·updated
$ /plugin marketplace add thedotmack/claude-mem && /plugin install claude-mem copy

What it does

Every new Claude Code session makes you re-explain prior decisions, which files you touched, and which bugs you fixed. Long sessions exhaust the context window and /compact inevitably drops important detail.

Claude-Mem runs a background observer agent that records and classifies Claude’s work in real time, compresses it with AI, and stores it. On the next session, only the relevant slice of project history is auto-injected — no more repeating yourself.

Features

  • Real-time observation — a dedicated observer agent emits searchable “observations” during the session, auto-classified as decisions, bug fixes, feature additions, and discoveries
  • Progressive Disclosure — a lightweight index (~2.1k tokens) loads at session start; detailed observations (~850 tokens each) load on demand, with token cost visible
  • mem-search skill — natural-language queries over project history (e.g. “find decisions about token refresh”, “what decisions touched index.ts?”)
  • Web Viewer — live memory stream at http://localhost:37777 for inspection and management
  • Claude Desktop skill — the same memory search is available in Desktop app conversations
  • Privacy control — content wrapped in <private> tags is excluded from storage
  • Citations — reference prior records by observation ID to trace provenance
  • Automatic operation — runs in the background after install; no extra commands required

Supported environments

ClientSupport
Claude Code✓ (plugin or NPX)
Claude Desktop✓ (memory search skill)
Gemini CLI✓ (--ide gemini-cli)
OpenCode✓ (--ide opencode)
Cursor IDE✓ (integration guide in docs)

Requirements

  • Node.js 18.0.0 or later
  • Claude Code (plugin-capable version)
  • Bun, uv, SQLite 3 — auto-installed/bundled during setup

Notes

  • Built by Alex Newman (@thedotmack). Architecture, integration guides, and advanced settings are at the official docs.
  • License is AGPL-3.0 — network-service distribution triggers source disclosure. The ragtime/ directory is under PolyForm Noncommercial instead.
  • Experimental features like Endless Mode are available on the beta channel.
  • This plugin isn’t on claude.com/plugins; add the marketplace first with /plugin marketplace add thedotmack/claude-mem, then install.
§ 6

See also

same category · curated
[01]
[Tool] Herdr · A terminal-native agent multiplexer in a single Rust binary. Herdr combines tmux-style session persistence and pane splits with agent awareness — a sidebar that shows whether each pane's agent is idle, working, blocked, or done — for Claude Code and other CLI agents. The direct Claude Code integration (`herdr integration install claude`) adds full state detection, semantic state forwarding over a local socket API, and agent-session restoration after a server restart.
tool · claudekit.io / tools / herdr
[02]
[Tool] CC Workflow Studio · Design workflows on a canvas in VS Code and export them as Markdown your AI agent already understands — skills, commands, and agents for Claude Code, Cursor, Copilot, and more. An MCP server runs in the background so you can refine workflows in natural language with 'Edit with AI'.
tool · claudekit.io / tools / cc-wf-studio
[03]
[Skill] Find Skills · A meta-skill that activates when users ask "how do I do X" or "is there a skill that can…", then searches the open agent skills ecosystem and walks the user through installation.
tool · claudekit.io / tools / find-skills
§ 7

Frequently Asked Questions

frequently asked
§ 7.1
What is Claude-Mem?
A persistent memory plugin where a background observer agent records, classifies, and compresses what happens during a Claude Code session, then re-injects the relevant items at the start of the next session. Built by Alex Newman (@thedotmack).
§ 7.2
Where does it run?
Claude Code, Claude Desktop, Gemini CLI, OpenCode, and Cursor IDE.
§ 7.3
How do I install it?
In Claude Code: `/plugin marketplace add thedotmack/claude-mem && /plugin install claude-mem`. A universal NPX install (`npx claude-mem install`) and IDE-specific options for Gemini CLI / OpenCode are also supported.
§ 7.4
What are the prerequisites?
Node.js 18.0.0+ and Claude Code (plugin-capable). Bun, uv, and SQLite 3 are installed or bundled during setup.
§ 7.5
What's the license?
AGPL-3.0 — network deployment triggers source-disclosure obligations. The `ragtime/` directory is licensed under PolyForm Noncommercial.
§ 7.6
Can I keep sensitive content out of memory?
Yes. Wrap content in `<private>` tags and it's excluded from storage.