🧭 Decision Guide
Why trending now: Cannot be determined from the material
Try it if you
-
You frequently start new sessions in Claude Code and need old session context restored automaticallyREADME Quick Start: after restarting Claude Code, context from previous sessions automatically appears in new sessions
-
Your agent environment is OpenCode, Grok Bot, or Antigravity CLIREADME Quick Start provides npx claude-mem install --ide opencode, --ide grok-bot, and --ide antigravity
-
You need natural-language retrieval over project history instead of storing only raw logsREADME Search Tools and How It Works: the mem-search Skill supports natural-language queries, while Chroma provides hybrid semantic + keyword search
-
You accept CMEM Pro hosted memory or are willing to use OpenRouter, Gemini, or an Anthropic planREADME Quick Start: after sign-in, users can choose the claude-mem observer, their own OpenRouter or Gemini key, or their Anthropic plan
Skip it if you
-
You require the default installation flow to work without signing inREADME Quick Start: the default installation asks for browser sign-in; --provider or CLAUDE_MEM_ONLINE_OPTIN=false can skip it
-
You plan to install the Claude Code plugin with npm install -g claude-memREADME Note: global npm installation provides only the SDK/library and does not register plugin hooks or set up the worker service
-
Your environment cannot provide Node.js 20.0.0, Bun, or uvREADME System Requirements explicitly requires Node.js 20.0.0+, Bun, and uv; missing components are auto-installed
-
Your Grok Bot chat records must not be monitored by a pluginREADME Quick Start: Grok Bot has no host hooks, so the plugin watches chat log files
Requirements
- Node.js 20.0.0 or higher
- Claude Code: Latest version with plugin support
- Bun: JavaScript runtime and process manager
- uv: Python package manager for vector search
- SQLite 3: For persistent storage (bundled)
First step (verbatim from README)
npx claude-mem install
Watch out
-
Do not substitute npm install -g claude-mem for the installer; it will not register plugin hooks or the worker serviceREADME Quick Start Note
-
The product is called Grok Mem while the package remains claude-mem, creating a naming mismatchREADME opening: Claude-Mem is now Grok Mem. The package is still claude-mem
-
CMEM Pro hosted memory is enabled by default; the local observer requires the explicit --provider host flagREADME Quick Start: Default is CMEM Pro; Local observer is opt-in: --provider host
-
Settings are stored in ~/.claude-mem/settings.json, including the AI model, worker port, and data directoryREADME Configuration section
-
On Windows, npm not recognized requires adding Node.js and npm to PATHREADME Windows Setup Notes
Not stated in the README
- The README does not provide exact subscription prices or quota details after the CMEM Pro trial ends.
- The README does not explain encryption or isolation for data in SQLite, Chroma, or chat logs.
- The README provides no performance figures for different AI models, worker ports, or project sizes.
- Project metadata lists 0 contributors, 0 releases, and 0 recent commits, so actual maintenance activity cannot be confirmed from the material.
- The README does not provide a complete compatibility matrix for Claude Code, OpenCode, Grok Bot, and Antigravity CLI versions.
- The README links to Architecture Evolution but does not provide concrete migration steps from claude-mem v3 to v5.
💡 Deep Analysis
6
No
I want multiple people to share claude-mem memory for one repository while requiring access isolation, concurrent writes, and team-level governance. Is it suitable as a shared knowledge base?
No: it should not be used directly as a team knowledge-base backend because the README describes a local Worker, SQLite storage, and personal Agent-plugin workflows without team authorization or concurrency governance.
- The Worker is a local HTTP API managed by Bun, while SQLite stores sessions, observations, and summaries. This is primarily a single-workstation architecture.
- Configuration lives at
~/.claude-mem/settings.json, with configurable data directory and Worker port, but those settings do not provide user-, project-, or role-level access control. - The README offers Cloud Sync to back up memories to cmem.ai, but backup does not itself address real-time collaboration, permission isolation, conflict resolution, or audit requirements.
- The project insights explicitly state that SQLite and the local Worker are better suited to personal or single-machine workflows and do not naturally solve multi-user writes, access isolation, organizational governance, or high availability.
It may serve as each member’s personal work memory, or the hosted service may be evaluated separately. The README does not justify treating local storage as a shared team knowledge backend.
- How It Works: “Worker Service - Local HTTP API with web viewer UI and search endpoints, managed by Bun”
- How It Works: “SQLite Database - Stores sessions, observations, summaries”
- Configuration: “Settings are managed in `~/.claude-mem/settings.json`”
- Project insight solution_analysis.usage_limitations: SQLite and the local Worker are better suited to personal or single-machine workflows
Yes
I use Claude Code, OpenCode, and Codex, and the project history no longer fits into one session. Can claude-mem retrieve old decisions on demand instead of requiring me to paste full transcripts?
Yes: its storage, compression, hybrid retrieval, and progressive disclosure directly address project history that no longer fits into one session.
- The Worker turns work into observations, summaries, decisions, and follow-up tasks rather than merely retaining raw chat text.
- SQLite FTS5 provides keyword search, while Chroma Vector Database provides semantic search. Exact terms such as filenames and error messages can therefore be searched alongside semantically similar historical decisions.
- The mem-search Skill supports natural-language queries and progressive disclosure: relevant summaries or observations can be retrieved first and details expanded on demand, instead of injecting the entire history at once.
- The README lists Claude Code and OpenCode integrations, while the project description lists Codex. However, equivalent integration depth across hosts is not guaranteed.
It is a good project-memory layer, but it should not replace the repository, tests, or formal design documents because AI compression can omit details.
- How It Works: “mem-search Skill - Natural language queries with progressive disclosure”
- How It Works: “Chroma Vector Database - Hybrid semantic + keyword search for intelligent context retrieval”
- How It Works: “SQLite Database - Stores sessions, observations, summaries”
- Project description: “Works with Claude Code, OpenClaw, Codex, Gemini, Hermes, Copilot, OpenCode + More”
npx claude-mem install
It depends
I use Grok Bot for continuous debugging, but Grok Bot has no host hooks. Can I rely on claude-mem to capture tool activity and subsequent decisions completely?
It depends: Grok Bot has a dedicated installation path, but collection relies on chat-log monitoring and is not equivalent to native lifecycle hooks.
- The README explicitly says, “Grok Bot has no host hooks, so we watch the chat log files.” It therefore does not capture events directly through host events such as SessionStart or PostToolUse.
- The Grok-specific installer configures
grok-bot; the default provider is CMEM Pro hosted memory, while the local observer requires--provider host. - Changes to log format or path, file permissions, or Grok platform updates can make collection incomplete. The project insights also identify weaker timeliness and coverage for this fallback integration.
- The README does not promise that every tool call will be captured and does not describe a recovery mechanism for missed events.
It is suitable as an auxiliary memory layer for Grok Bot, but not as a complete audit log or the sole source of truth for debugging decisions.
- Quick Start: “Grok Bot has no host hooks, so we watch the chat log files.”
- Quick Start: “Default is CMEM Pro, the hosted memory. Local observer is opt-in: `--provider host`.”
- Project insight user_experience.common_pitfalls: Grok Bot relies on chat-log files, and format, permission, or path changes may cause incomplete capture
npx claude-mem install --ide grok-bot
It depends
I use Claude Code, already have my own OpenRouter and Gemini keys, and do not want to default to a hosted subscription. Can claude-mem switch providers while making the cost boundary clear?
It depends: provider selection is supported, but the README documents the entry points and trial behavior rather than complete pricing, model-call volume, or performance differences.
- After installation and sign-in, users can choose the claude-mem observer, their own OpenRouter or Gemini key, or their Anthropic plan, so the setup is not locked to one vendor.
- The claude-mem observer runs off-plan and is free for the first 30 days; after the trial, memory automatically falls back to the Anthropic plan unless the user subscribes. This affects cost attribution.
- An explicit
--providerflag,CLAUDE_MEM_ONLINE_OPTIN=false, or CI/non-interactive installation can skip account interaction, which supports a provider-controlled setup. - The README does not list exact supported models, calls per observation/summarization/vector search, or how OpenRouter and Gemini key usage is billed.
Provider switching is therefore feasible, but the README is insufficient for budgeting. Configuration details and each provider’s pricing documentation are still required.
- Quick Start: “you pick your memory provider — the claude-mem observer, your own OpenRouter or Gemini key, or your Anthropic plan”
- Quick Start: “memory that runs off-plan, free for your first 30 days”
- Quick Start: “After the free trial ends, memory automatically falls back to your Anthropic plan unless you subscribe.”
- Quick Start: “Pass an explicit `--provider` flag, set `CLAUDE_MEM_ONLINE_OPTIN=false`”
npx claude-mem install
It depends
I use the latest Claude Code with plugin support, work on confidential commercial code, and need cross-session context without sending session content to an external service. Is claude-mem suitable?
It depends: claude-mem fits local persistence and cross-session recovery only if you explicitly select a local provider and accept its local runtime requirements.
- The README says SQLite stores sessions, observations, and summaries, and that the data directory is configurable.
- Its lifecycle integration includes SessionStart, UserPromptSubmit, PostToolUse, Stop, and SessionEnd; after restarting Claude Code, context from previous sessions appears automatically.
- The normal installer asks users to sign in and choose the claude-mem observer, OpenRouter, Gemini, or an Anthropic plan. An online provider may process session content, so the default flow should not be treated as offline.
- Local persistence still requires Node.js 20+, Bun, uv, and SQLite. The supplied README does not clearly state whether observation and summarization models can run entirely locally.
It is reasonable when the provider’s privacy boundary is acceptable. If the policy forbids sending any code outside the workstation, verify the provider’s network behavior before installation.
- How It Works: “SQLite Database - Stores sessions, observations, summaries”
- How It Works: “5 Lifecycle Hooks - SessionStart, UserPromptSubmit, PostToolUse, Stop, SessionEnd”
- Quick Start: “After sign-in you pick your memory provider”
- System Requirements: “Node.js: 20.0.0 or higher”, “Bun”, “uv”, “SQLite 3”
npx claude-mem install
It depends
I need to configure claude-mem for both OpenCode and Antigravity CLI, and installation will run in a CI/non-interactive shell. Are the README’s supported paths sufficient?
It depends: the README provides installation commands for both hosts and supports non-interactive installation, but CI reliability still depends on runtime availability and provider configuration.
- OpenCode and Antigravity CLI each have a dedicated
npx claude-mem install --ide ...command, giving both integrations an explicit setup path. - The README says installation can complete without account interaction in CI/non-interactive shells. It also documents
--providerandCLAUDE_MEM_ONLINE_OPTIN=falsefor skipping sign-in. - Node.js 20+ is required. Bun and uv can be auto-installed when missing, but CI PATH, network access, and filesystem permissions may affect that process.
- The installer configures the plugin and Worker. The README does not explain whether a CI job must keep the Worker alive, nor does it describe hook coverage differences between OpenCode and Antigravity CLI.
Thus, non-interactive setup is supported. If the CI job exits immediately after installation, whether collection and retrieval remain usable is not established by the README.
- Quick Start: `npx claude-mem install --ide opencode`
- Quick Start: `npx claude-mem install --ide antigravity`
- Quick Start: “run in CI/non-interactive shells — the installer completes without any account interaction”
- System Requirements: “Node.js: 20.0.0 or higher”; “Bun” and “uv”
npx claude-mem install --ide opencode
✨ Highlights
-
SQLite stores sessions while Chroma provides hybrid semantic search
-
5 lifecycle hooks automatically capture and inject context
-
Supports Claude Code, OpenCode, and Grok Bot
-
93,134 stars and natural-language project history queries
🔧 Engineering
-
Uses SQLite to store sessions, observations, and summaries
-
The mem-search Skill queries project history in natural language
-
Worker Service provides an HTTP API, web viewer, and search endpoints
-
5 lifecycle hooks automatically restore historical context in new sessions
⚠️ Risks
-
CMEM Pro hosted memory is the default, and installation prompts for browser sign-in
-
Grok Bot has no host hooks, so the plugin watches chat log files instead
-
npm install -g claude-mem installs only the SDK and does not register plugin hooks
-
The runtime requires Node.js 20, Bun, uv, and SQLite 3
-
The README renamed the product to Grok Mem, but the npm package remains claude-mem
👥 For who?
-
Claude Code plugin users who need work context preserved across sessions
-
Agent teams using OpenCode, Grok Bot, or Antigravity CLI
-
TypeScript projects with Node.js 20, Bun, and uv already available