How to install claude-mem on Claude Code

Requires Node.js 18+ and Claude Code installed.

1

Install

Via npx or plugin marketplace. First launch pulls dependencies (better-sqlite3, PM2) — about 30 seconds, one time only.

npx claude-mem install
/plugin marketplace add thedotmack/claude-mem
/plugin install claude-mem
2

Restart

Restart Claude Code. Plugin runs in the background, no action needed from you.

3

Check Status

Verify it's running via process check, logs, or web viewer.

ps aux | grep worker-service
tail -f ~/.claude-mem/logs/worker-out.log
http://localhost:37777
4

Use It

Just work in Claude Code as usual. The plugin captures tool calls, compresses with Claude agent-sdk, stores in local SQLite + Chroma.

Example Queries

  • → "What did we work on yesterday?"
  • → "Find all bugfixes from last week"
  • → "Show me database-related changes"

Privacy

Wrap sensitive content in <private>...</private> tags to exclude from capture. All data stored in ~/.claude-mem/, no external API calls.

Also works with: Cursor, Gemini CLI, Windsurf, OpenCode.
GitHub Docs Site

Related pages

Claude Code .claude/ Folder Explained — Full Map

Master the complete Claude Code .claude/ folder map. Learn how to configure CLAUDE.md, MCP servers, hooks, skills, and agents to optimize your AI workflows.

Claude Code + Remotion

Turn any website link into a video using Claude Code and Remotion. Follow our step-by-step guide to easily generate promo videos and highlight reels today.

The Official Anthropic Skills Repo

Unlock the official Anthropic Skills repo that most developers overlook. Discover what is inside and learn how to install open-standard skills in Claude Code.

6 Claude Code Plugins: From Code Review to Persistent Memory

Explore 6 Claude Code plugins to empower your AI agent. Automate complex marketplace workflows, add persistent memory, and scale your e-commerce operations.

Anthropic's Free Claude Cowork Course: 3 Power Moves

Master Anthropic's free Claude Cowork course to earn your certificate. Learn three power moves to automate daily workflows and get ahead of 95% of AI users.

claude code commands

Master all essential Claude Code commands with this complete 2026 cheat sheet. Save your AI quota, manage context, and optimize your coding workflow today.