supermemoryai/claude-supermemoryPublic

Enable Claude Code to learn in real-time, update it's knowledge, and grow with you, using supermemory.

AI summary: A plugin providing persistent, vector-backed long-term memory for Claude Code sessions.

Stars
2.8K
+-2 today
Forks
174
Watchers
18
Open issues
8
Open PRs
9
Contributors
~17
Commits
242
Branches
87
Views (30d)
4

JavaScriptNo licenseCreated Jan 22, 2026Last push 5d agoLatest release v0.0.2+-1 stars this week+8 this month

Quick answers

What is claude-supermemory?
A plugin providing persistent, vector-backed long-term memory for Claude Code sessions.
What does claude-supermemory do?
Claude Supermemory is a specialized plugin that bridges Anthropic's Claude API with a persistent vector database, effectively bypassing standard context window limitations. It operates by intercepting user queries, retrieving highly relevant historical context from past interactions, and intelligently injecting it into the prompt. The system features a 'reasoned recall' mechanism, where Claude autonomously evaluates if searching its memory bank will actually benefit the current conversational turn. This allows the agent to remember complex project details, user preferences, and past discussions over extended periods.
Who is claude-supermemory for?
Power users and developers who utilize Claude Code extensively and require it to maintain deep, long-term context across numerous projects. Ideal for engineers building solutions with JavaScript.
How do I get started with claude-supermemory?
/plugin marketplace add supermemoryai/claude-supermemory
How popular is claude-supermemory on GitHub?
supermemoryai/claude-supermemory has 2,802 stars and 174 forks on GitHub, and gained -1 stars in the last 7 days.

Star history

since Jul 29, 2026
01K2KJul 2026Sep 2026Oct 2026Nov 2026
2.8K stars as of Nov 20, 2026. Measured daily since Jul 29, 2026; GitHub no longer exposes earlier star timestamps.

Update history

1 recorded
  • Oct 29, 2026Primary language changed from HTML to JavaScript.

Contribution activity

commits per day, last 52 weeks
NovDecJanFebMarAprMayJunJulAugSepOctNovMonWedFri2025-11-23: 0 commits2025-11-24: 0 commits2025-11-25: 0 commits2025-11-26: 0 commits2025-11-27: 0 commits2025-11-28: 0 commits2025-11-29: 0 commits2025-11-30: 0 commits2025-12-01: 0 commits2025-12-02: 0 commits2025-12-03: 0 commits2025-12-04: 0 commits2025-12-05: 0 commits2025-12-06: 0 commits2025-12-07: 0 commits2025-12-08: 0 commits2025-12-09: 0 commits2025-12-10: 0 commits2025-12-11: 0 commits2025-12-12: 0 commits2025-12-13: 0 commits2025-12-14: 0 commits2025-12-15: 0 commits2025-12-16: 0 commits2025-12-17: 0 commits2025-12-18: 0 commits2025-12-19: 0 commits2025-12-20: 0 commits2025-12-21: 0 commits2025-12-22: 0 commits2025-12-23: 0 commits2025-12-24: 0 commits2025-12-25: 0 commits2025-12-26: 0 commits2025-12-27: 0 commits2025-12-28: 0 commits2025-12-29: 0 commits2025-12-30: 0 commits2025-12-31: 0 commits2026-01-01: 0 commits2026-01-02: 0 commits2026-01-03: 0 commits2026-01-04: 0 commits2026-01-05: 0 commits2026-01-06: 0 commits2026-01-07: 0 commits2026-01-08: 0 commits2026-01-09: 0 commits2026-01-10: 0 commits2026-01-11: 0 commits2026-01-12: 0 commits2026-01-13: 0 commits2026-01-14: 0 commits2026-01-15: 0 commits2026-01-16: 0 commits2026-01-17: 0 commits2026-01-18: 0 commits2026-01-19: 0 commits2026-01-20: 0 commits2026-01-21: 2 commits2026-01-22: 2 commits2026-01-23: 1 commit2026-01-24: 0 commits2026-01-25: 0 commits2026-01-26: 0 commits2026-01-27: 0 commits2026-01-28: 0 commits2026-01-29: 5 commits2026-01-30: 1 commit2026-01-31: 0 commits2026-02-01: 0 commits2026-02-02: 1 commit2026-02-03: 0 commits2026-02-04: 1 commit2026-02-05: 5 commits2026-02-06: 1 commit2026-02-07: 0 commits2026-02-08: 1 commit2026-02-09: 0 commits2026-02-10: 0 commits2026-02-11: 1 commit2026-02-12: 0 commits2026-02-13: 0 commits2026-02-14: 0 commits2026-02-15: 0 commits2026-02-16: 2 commits2026-02-17: 0 commits2026-02-18: 0 commits2026-02-19: 3 commits2026-02-20: 0 commits2026-02-21: 0 commits2026-02-22: 0 commits2026-02-23: 0 commits2026-02-24: 0 commits2026-02-25: 0 commits2026-02-26: 0 commits2026-02-27: 0 commits2026-02-28: 0 commits2026-03-01: 0 commits2026-03-02: 0 commits2026-03-03: 0 commits2026-03-04: 1 commit2026-03-05: 1 commit2026-03-06: 0 commits2026-03-07: 1 commit2026-03-08: 0 commits2026-03-09: 0 commits2026-03-10: 0 commits2026-03-11: 0 commits2026-03-12: 0 commits2026-03-13: 0 commits2026-03-14: 0 commits2026-03-15: 0 commits2026-03-16: 0 commits2026-03-17: 0 commits2026-03-18: 0 commits2026-03-19: 0 commits2026-03-20: 0 commits2026-03-21: 0 commits2026-03-22: 0 commits2026-03-23: 0 commits2026-03-24: 0 commits2026-03-25: 0 commits2026-03-26: 0 commits2026-03-27: 0 commits2026-03-28: 0 commits2026-03-29: 0 commits2026-03-30: 0 commits2026-03-31: 0 commits2026-04-01: 0 commits2026-04-02: 0 commits2026-04-03: 0 commits2026-04-04: 0 commits2026-04-05: 0 commits2026-04-06: 0 commits2026-04-07: 0 commits2026-04-08: 0 commits2026-04-09: 0 commits2026-04-10: 0 commits2026-04-11: 0 commits2026-04-12: 0 commits2026-04-13: 0 commits2026-04-14: 0 commits2026-04-15: 0 commits2026-04-16: 0 commits2026-04-17: 0 commits2026-04-18: 0 commits2026-04-19: 0 commits2026-04-20: 0 commits2026-04-21: 0 commits2026-04-22: 0 commits2026-04-23: 0 commits2026-04-24: 0 commits2026-04-25: 0 commits2026-04-26: 0 commits2026-04-27: 0 commits2026-04-28: 0 commits2026-04-29: 0 commits2026-04-30: 0 commits2026-05-01: 0 commits2026-05-02: 0 commits2026-05-03: 0 commits2026-05-04: 0 commits2026-05-05: 0 commits2026-05-06: 0 commits2026-05-07: 0 commits2026-05-08: 0 commits2026-05-09: 0 commits2026-05-10: 0 commits2026-05-11: 0 commits2026-05-12: 0 commits2026-05-13: 0 commits2026-05-14: 1 commit2026-05-15: 0 commits2026-05-16: 0 commits2026-05-17: 0 commits2026-05-18: 0 commits2026-05-19: 0 commits2026-05-20: 0 commits2026-05-21: 0 commits2026-05-22: 3 commits2026-05-23: 0 commits2026-05-24: 0 commits2026-05-25: 0 commits2026-05-26: 0 commits2026-05-27: 0 commits2026-05-28: 1 commit2026-05-29: 0 commits2026-05-30: 0 commits2026-05-31: 2 commits2026-06-01: 0 commits2026-06-02: 0 commits2026-06-03: 1 commit2026-06-04: 3 commits2026-06-05: 0 commits2026-06-06: 1 commit2026-06-07: 0 commits2026-06-08: 1 commit2026-06-09: 1 commit2026-06-10: 3 commits2026-06-11: 5 commits2026-06-12: 1 commit2026-06-13: 1 commit2026-06-14: 0 commits2026-06-15: 1 commit2026-06-16: 4 commits2026-06-17: 2 commits2026-06-18: 2 commits2026-06-19: 0 commits2026-06-20: 0 commits2026-06-21: 0 commits2026-06-22: 0 commits2026-06-23: 0 commits2026-06-24: 0 commits2026-06-25: 0 commits2026-06-26: 0 commits2026-06-27: 0 commits2026-06-28: 0 commits2026-06-29: 0 commits2026-06-30: 0 commits2026-07-01: 0 commits2026-07-02: 0 commits2026-07-03: 0 commits2026-07-04: 0 commits2026-07-05: 0 commits2026-07-06: 0 commits2026-07-07: 0 commits2026-07-08: 0 commits2026-07-09: 0 commits2026-07-10: 0 commits2026-07-11: 0 commits2026-07-12: 0 commits2026-07-13: 1 commit2026-07-14: 1 commit2026-07-15: 0 commits2026-07-16: 2 commits2026-07-17: 0 commits2026-07-18: 1 commit2026-07-19: 0 commits2026-07-20: 0 commits2026-07-21: 0 commits2026-07-22: 0 commits2026-07-23: 0 commits2026-07-24: 2 commits2026-07-25: 1 commit2026-07-26: 0 commits2026-07-27: 0 commits2026-07-28: 0 commits2026-07-29: 0 commits2026-07-30: 0 commits2026-07-31: 0 commits2026-08-01: 0 commits2026-08-02: 0 commits2026-08-03: 0 commits2026-08-04: 0 commits2026-08-05: 2 commits2026-08-06: 0 commits2026-08-07: 0 commits2026-08-08: 1 commit2026-08-09: 0 commits2026-08-10: 0 commits2026-08-11: 0 commits2026-08-12: 6 commits2026-08-13: 1 commit2026-08-14: 1 commit2026-08-15: 0 commits2026-08-16: 0 commits2026-08-17: 0 commits2026-08-18: 24 commits2026-08-19: 0 commits2026-08-20: 0 commits2026-08-21: 3 commits2026-08-22: 0 commits2026-08-23: 0 commits2026-08-24: 0 commits2026-08-25: 0 commits2026-08-26: 0 commits2026-08-27: 0 commits2026-08-28: 0 commits2026-08-29: 0 commits2026-08-30: 0 commits2026-08-31: 1 commit2026-09-01: 1 commit2026-09-02: 0 commits2026-09-03: 2 commits2026-09-04: 0 commits2026-09-05: 1 commit2026-09-06: 0 commits2026-09-07: 1 commit2026-09-08: 0 commits2026-09-09: 0 commits2026-09-10: 0 commits2026-09-11: 0 commits2026-09-12: 0 commits2026-09-13: 0 commits2026-09-14: 0 commits2026-09-15: 0 commits2026-09-16: 2 commits2026-09-17: 2 commits2026-09-18: 0 commits2026-09-19: 0 commits2026-09-20: 0 commits2026-09-21: 0 commits2026-09-22: 0 commits2026-09-23: 0 commits2026-09-24: 0 commits2026-09-25: 0 commits2026-09-26: 0 commits2026-09-27: 0 commits2026-09-28: 0 commits2026-09-29: 0 commits2026-09-30: 0 commits2026-10-01: 0 commits2026-10-02: 1 commit2026-10-03: 10 commits2026-10-04: 4 commits2026-10-05: 0 commits2026-10-06: 1 commit2026-10-07: 1 commit2026-10-08: 0 commits2026-10-09: 7 commits2026-10-10: 0 commits2026-10-11: 0 commits2026-10-12: 8 commits2026-10-13: 0 commits2026-10-14: 0 commits2026-10-15: 0 commits2026-10-16: 1 commit2026-10-17: 0 commits2026-10-18: 0 commits2026-10-19: 7 commits2026-10-20: 0 commits2026-10-21: 0 commits2026-10-22: 0 commits2026-10-23: 1 commit2026-10-24: 0 commits2026-10-25: 0 commits2026-10-26: 2 commits2026-10-27: 1 commit2026-10-28: 0 commits2026-10-29: 1 commit2026-10-30: 0 commits2026-10-31: 0 commits2026-11-01: 0 commits2026-11-02: 0 commits2026-11-03: 0 commits2026-11-04: 0 commits2026-11-05: 1 commit2026-11-06: 0 commits2026-11-07: 0 commits2026-11-08: 0 commits2026-11-09: 0 commits2026-11-10: 0 commits2026-11-11: 0 commits2026-11-12: 0 commits2026-11-13: 1 commit2026-11-14: 0 commits2026-11-15: 0 commits2026-11-16: 0 commits2026-11-17: 0 commits2026-11-18: 0 commits2026-11-19: 0 commits2026-11-20: 0 commits2026-11-21: 0 commits
165 commits in the last yearLessMore

Signals and awards

derived from tracked data
  • Continuous integration

    Automated checks passing

  • Repeat trending

    3 trending appearances

What claude-supermemory does

Claude Supermemory is a specialized plugin that bridges Anthropic's Claude API with a persistent vector database, effectively bypassing standard context window limitations. It operates by intercepting user queries, retrieving highly relevant historical context from past interactions, and intelligently injecting it into the prompt. The system features a 'reasoned recall' mechanism, where Claude autonomously evaluates if searching its memory bank will actually benefit the current conversational turn. This allows the agent to remember complex project details, user preferences, and past discussions over extended periods.

Power users and developers who utilize Claude Code extensively and require it to maintain deep, long-term context across numerous projects. Ideal for engineers building solutions with JavaScript.

  • Vector-backed storage: Persistently saves conversation history in an optimized vector database for accurate, long-term retention.
  • Reasoned recall mechanism: Claude actively decides whether querying memory is necessary for the current task before executing a search.
  • Team knowledge sharing: Supports project-level memory that can be shared across a team, kept separate from individual user data.
  • Automated capture: Intelligently analyzes and saves relevant conversational context automatically when a coding session ends.
  • Granular configuration: Allows per-repository settings, API key management, and container tagging for isolated development environments.

Where teams use it

Personalized AI assistance

Creates a tailored coding companion that remembers specific syntax preferences and past architectural discussions.

Extended project development

Maintains deep context over weeks of work on a complex codebase, preventing the need to repeatedly paste large files.

Team knowledge base

Builds a searchable repository of decisions and context that any team member's agent can access and utilize.

Contextual debugging

Allows the agent to recall previous, similar bugs and the methods used to solve them in past sessions.

Getting started: /plugin marketplace add supermemoryai/claude-supermemory

README

main branch

claude-supermemory

Persistent memory for Claude Code, powered by Supermemory

version license

Conceptual overview of Claude Code and Supermemory

Conceptual overview. Some command names in the image predate the current plugin; see Commands for what's available now.

A Claude Code plugin that gives your agent persistent memory across sessions using Supermemory. Your agent remembers what you worked on, across sessions and across projects.


Installation

Requires Node.js 18+ on your PATH. The memory hooks run as Node scripts.

/plugin marketplace add supermemoryai/claude-supermemory
/plugin install supermemory

Set your API key (get one at console.supermemory.ai), or just start a session and let browser login handle it:

export SUPERMEMORY_CC_API_KEY="sm_..."
Migrating from the old claude-supermemory plugin

That plugin was renamed to supermemory, so it won't update in place. Migrate with:

/plugin marketplace update supermemory-plugins
/plugin install supermemory@supermemory-plugins

Then, only if you still have the old plugin installed, remove it:

/plugin uninstall claude-supermemory@supermemory-plugins

Features

🧠 Direct recall
When authenticated, the hook searches substantive prompts before Claude sees them and injects fresh matches. No permission prompt or MCP tool call.
🔎 Hosted MCP tools
search_memory, listSpaces, whoAmI, and more are available through the same credentials as the hooks, subject to your Claude Code permissions.
💾 Auto capture
At the end of a session, the Stop hook saves new conversation content in the background. It asks Supermemory to retain durable context rather than transient Git state.
🏷️ Shared repo memory
Automatic captures use the repository container shared with Codex and OpenCode and carry sm_scope: personal metadata.
🧭 Deep multi-container search
The context-gatherer subagent fans out several searches across a project's containers and returns a synthesized brief.
⚙️ Project config
Per-repo settings, API keys, and container tag overrides via .claude/.supermemory-claude/config.json.
🗂️ Codebase index
/supermemory:index saves architecture, conventions, and how to run into this project's container.
👋 Session context
Loads profile facts at session start and shows a welcome-back notice when you return to a project after 6+ hours.
  • Recall strip — On Claude Code 2.1.287+ in the terminal, press the changing memory headline above the prompt to browse the full returned facts one at a time

On Claude Code 2.1.250, local marketplace install/update and the SessionStart and UserPromptSubmit command hooks were verified, but claude plugin validate rejects the recall mod's classic.SessionStart event. The strip is not available on that version; other older versions and install sources have not been verified.

How it works

Claude Code supports hooks and MCP servers. supermemory registers four hooks, in lifecycle order:

SessionStart → UserPromptSubmit → PreToolUse → Stop

Step Hook Event What it does
1 session-start SessionStart Bootstraps auth and loads profile context plus a welcome-back notice. It does not install a statusline; an old auto-installed one is removed.
2 recall-directive UserPromptSubmit Searches Supermemory directly with the prompt and injects fresh matches, deduplicated within the session.
3 recall-approve PreToolUse Displays read-only Supermemory activity without approving calls or changing their input.
4 capture Stop Saves the completed conversation delta in the background.

By default, recall is performed by the hook itself, not delegated to the model. It searches substantive prompts when authenticated, without waiting for Claude to choose a tool call. Setting recallDirective switches to advisory mode: the hook stops searching and instead tells Claude when it should decide to search on its own.

The hooks are tolerant: if Supermemory is unreachable, the API key is missing, or anything else fails, they exit cleanly without breaking your Claude Code session. A capture that fails is reported the next time a session starts.

Directory review and permissions

MCP tool calls follow your Claude Code permission rules. The PreToolUse hook only displays recall activity and records search counts; it does not approve calls or change their input. The index and status commands do not grant blanket shell access. Direct recall and capture still run as the lifecycle hooks you enabled when installing the plugin.

The MCP declaration passes https://mcp.supermemory.ai/mcp literally to the bundled proxy as its default endpoint. The proxy uses that argument for the standard hosted configuration, shares the hooks' authentication, and supplies the current repository's default container. Existing SUPERMEMORY_MCP_URL, custom API backend settings, API keys, stored credentials, and OAuth refresh remain supported. Running the proxy without the argument retains its previous endpoint resolution.

The optional recall-strip mod observes classic.SessionStart and classic.UserPromptSubmit. It calls next(e) with the original event, reads returned memory facts for its terminal display, and returns the same result object. It does not replace the first user message, edit permission settings, register agents, or alter tool inputs. Its ui.render hook adds the expandable recall strip above the terminal prompt. The Directory's static policy check may still require a reviewer to confirm this pass-through behavior.

The credential-related review holds require review of the existing Supermemory sign-in flow, not a replacement of users' keys. Credentials are used for the configured Supermemory API and MCP endpoints. No new user_config credential flow is introduced by this change. Directory acceptance and publisher ownership must be confirmed in the submission portal; local validation is not approval.

Shared Agents memory

Claude Code, Codex, and OpenCode all generate the same container tag for a given repository, so new memories are shared:

repo_<project-name>__<remote-hash>   default container for capture and MCP memory tools
sm_scope: personal                   metadata on automatic captures

The hash is derived from the normalized Git remote, so clones share memory while same-named repositories do not collide. Repositories without a remote fall back to a local path identity. Linked worktrees (git worktree add, Conductor, Claude Squad, claude --worktree) resolve to the main checkout's identity, with or without a remote. Set SUPERMEMORY_ISOLATE_WORKTREES=true to use the worktree path instead of the remote identity.

Unlike Codex, this plugin does not read older per-tool legacy containers (codex_user_*, opencode_project_*, and similar); it only ever uses the single unified identity above, overridden via the project namespace setting or the compatible repoContainerTag / SUPERMEMORY_REPO_TAG settings.

Which sessions are remembered

By default the hooks make no Supermemory calls (no profile, no prompt recall, no capture) for sessions nobody is typing into. They decide this only from signals Claude Code sets:

Session Signal Opt back in
Background subagent results relayed to the main session the <task-notification> turn (origin.kind: "task-notification" in the transcript; scheduled fires and inbox messages still count as yours) captureSubagents: true / SUPERMEMORY_CAPTURE_SUBAGENTS=true
claude -p and GitHub Action runs CLAUDE_CODE_ENTRYPOINT is claude-code-github-action, or sdk-cli while that Claude Code process is itself in print mode (CLAUDE_CODE_SESSION_ATTENDED=0, or -p / --print / --output-format on older builds) captureHeadless: true / SUPERMEMORY_CAPTURE_HEADLESS=true

Subagents never run these hooks: Claude Code fires only SubagentStart and SubagentStop inside them, so their work reaches memory only through the main session. Claude Code's own helper prompts (session titles, prompt suggestions, the auto mode classifier) never run these hooks either.

An interactive claude that merely inherited CLAUDE_CODE_ENTRYPOINT=sdk-cli (for example one started from a shell a claude -p run spawned) stays on. Agent SDK apps (sdk-ts, sdk-py), including editors such as Zed that drive Claude Code over ACP, are treated as interactive and keep recall and capture. To keep an SDK app out of memory, run it without this plugin: leave "user" out of the SDK's settingSources, or disable the plugin for that app.

Sessions started by Conductor or Vibe Kanban (CONDUCTOR_WORKSPACE_PATH, CONDUCTOR_SESSION_ID or VK_WORKSPACE_ID set) are real user work and stay on even though they run through claude -p; set captureOrchestrated: false or SUPERMEMORY_CAPTURE_ORCHESTRATED=false to turn them off. Crystal sets no such variable, so its claude -p sessions count as headless.

For swarms that replay one task across many sessions, two local indexes in ~/.supermemory-claude (hashes only) cut repeats:

  • Opening prompt: a session whose opening prompt (at least 200 characters) was already captured from this machine for the same container in the last 24 hours saves the session with a one-line [opening prompt already captured from this machine: <hash>] marker in place of the prompt. Opt out with dedupeOpeningPrompt: false / SUPERMEMORY_DEDUPE_OPENING_PROMPT=false.
  • Recall query: when the exact same query (whitespace-normalized) was recalled successfully by another session for the same container in the last 10 minutes, the hook re-serves that result from recall-cache.json instead of calling the API. A failed or timed-out search is never cached. Opt out with dedupeRecallQueries: false / SUPERMEMORY_DEDUPE_RECALL_QUERIES=false.

Configuration

Environment variables

Variable Purpose
SUPERMEMORY_CC_API_KEY Your Supermemory API key (browser auth is preferred).
SUPERMEMORY_API_URL Override the Supermemory REST base URL; custom URLs default to legacy compatibility.
SUPERMEMORY_MCP_URL Override the hosted MCP endpoint (default https://mcp.supermemory.ai/mcp).
SUPERMEMORY_AUTH_URL Override the browser-auth base URL.
SUPERMEMORY_REPO_TAG Project-scope override; used when no project scope setting is set.
SUPERMEMORY_ISOLATE_WORKTREES Set to true to key the project container on the worktree path instead of the Git remote.
SUPERMEMORY_DEBUG Set to true to enable debug logging.
SUPERMEMORY_CAPTURE_SUBAGENTS true/1/yes/on or false/0/no/off; overrides captureSubagents.
SUPERMEMORY_CAPTURE_HEADLESS true/1/yes/on or false/0/no/off; overrides captureHeadless.
SUPERMEMORY_CAPTURE_ORCHESTRATED true/1/yes/on or false/0/no/off; overrides captureOrchestrated.
SUPERMEMORY_DEDUPE_OPENING_PROMPT true/1/yes/on or false/0/no/off; overrides dedupeOpeningPrompt.
SUPERMEMORY_DEDUPE_RECALL_QUERIES true/1/yes/on or false/0/no/off; overrides dedupeRecallQueries.

Global settings (~/.supermemory-claude/settings.json)

{
  "maxProfileItems": 5,
  "signalExtraction": true,
  "signalKeywords": ["remember", "architecture", "decision", "bug", "fix"],
  "signalTurnsBefore": 3,
  "includeTools": ["Edit", "Write"]
}
Option Description
maxProfileItems Max memories in context (default: 5).
recallDirective Set to switch prompt recall from direct hook search to an advisory instruction Claude reasons over.
signalExtraction Only capture important turns (default: false).
signalKeywords Keywords that trigger capture.
signalTurnsBefore Context turns before signal (default: 3).
includeTools Tool calls to explicitly capture.
debug Enable debug logging (default: false).
captureSubagents Recall and capture for relayed background-subagent results (default: false).
captureHeadless Recall and capture for claude -p and GitHub Action runs (default: false).
captureOrchestrated Recall and capture for Conductor and Vibe Kanban sessions (default: true).
dedupeOpeningPrompt Replace an opening prompt of 200+ characters captured from this machine in the last 24 hours with a marker (default: true).
dedupeRecallQueries Re-serve the cached result of the same query another session recalled in the last 10 minutes (default: true).

Project config (.claude/.supermemory-claude/config.json)

Per-repo overrides, created manually or via the settings your team shares:

API key precedence is SUPERMEMORY_CC_API_KEY, project apiKey, then ~/.supermemory-claude/credentials.json.

{
  "apiKey": "sm_...",
  "baseUrl": "https://api.supermemory.ai",
  "namespace": "my-team-project",
  "signalExtraction": true
}
Option Description
apiKey Project-specific API key.
baseUrl Supermemory API URL.
namespace Canonical project scope, preserving the exact old container-tag value.
repoContainerTag Override the unified project container tag. Checked before SUPERMEMORY_REPO_TAG.

Advanced self-hosted compatibility

Hosted Supermemory uses v5 without a version choice. Existing custom REST URLs default to legacy, keeping v3 writes and v4 profiles for self-hosted servers older than 0.0.9. After upgrading the server, explicitly set SUPERMEMORY_API_VERSION=v5 or project apiVersion: "v5". The environment setting takes precedence; legacy is also an explicit rollback option for a server that still supports v3/v4. Invalid values fail closed for memory operations. There is no automatic version fallback after a failed request and no fallback to the hosted API. REST, MCP, and browser-auth URLs remain separate.

Scope precedence is project namespace, project repoContainerTag, SUPERMEMORY_REPO_TAG, then the generated identity. Keep an existing override's exact value when renaming its setting: changing the value selects another space, not a data migration. V5 scopes allow 1–100 letters, digits, underscores, hyphens, or colons; invalid scopes are rejected before any request without rewriting config or capture cursors.

Hosted Supermemory applies the same rule to legacy endpoints, so a scope with a dot, slash, or space must be renamed; the new value starts a new memory space. A self-hosted server that still accepts such a scope through v3/v4 can keep it with SUPERMEMORY_API_VERSION=legacy or project apiVersion: "legacy". There is no automatic switch or failed-write retry across protocols.

Commands

Command Description
/supermemory:index Index this repo's architecture, conventions, and how to run into the project container.
/supermemory:status Show authentication status, API and MCP reachability, and the active project container.

Search does not have its own command. With a key, the prompt hook searches substantive prompts. For deeper history, use the context-gatherer agent or the MCP tools. /supermemory:index saves codebase structure. For a one-off save, ask Claude to use the add_memory MCP tool. Without containerTag, the proxy defaults it to this repository's container; pass a different tag to select another space. Conversation turns are saved when a session ends.

Privacy

Automatic capture sends new conversation content to Supermemory, including tool content when configured. Before saving, an offline filter replaces common credential-shaped values (provider tokens, credential assignments, private keys, Bearer tokens, and URL credentials) with explicit [REDACTED:…] markers while keeping surrounding context. It cannot detect every secret. Existing stored memories and local transcripts are not rewritten; explicit MCP tool calls and recall queries are not filtered by this capture-only protection.

For information about how Supermemory collects, uses, and retains data, see the Supermemory Privacy Policy.

License

MIT

Development runtime

Marketplace installations need only Node 18 or later, not npm install. plugin/hooks/vendor/supermemory.cjs is the committed runtime bundle built from the exact official SDK and esbuild versions in package-lock.json. Maintainers reproduce it with npm ci && npm run build:sdk; CI rejects a stale bundle. The SDK's Apache-2.0 license is included alongside the generated bundle.


◪ is the supermemory mark. Whenever you see it (the recall strip, notices, or Claude's answers), that information came from supermemory.
View on GitHub

Recent activity

commits and pull requests

Releases and announcements

1 total
  1. Claude Supermemory V2v0.0.2Feb 9, 2026

Code frequency

additions and deletions
+9.2K-9.2KWeek of 2026-01-18: +3,223 linesWeek of 2026-01-18: -1,284 linesWeek of 2026-01-25: +1,351 linesWeek of 2026-01-25: -450 linesWeek of 2026-02-01: +1,541 linesWeek of 2026-02-01: -730 linesWeek of 2026-02-08: +117 linesWeek of 2026-02-08: -90 linesWeek of 2026-02-15: +321 linesWeek of 2026-02-15: -26 linesWeek of 2026-02-22: +0 linesWeek of 2026-02-22: -0 linesWeek of 2026-03-01: +71 linesWeek of 2026-03-01: -63 linesWeek of 2026-03-08: +0 linesWeek of 2026-03-08: -0 linesWeek of 2026-03-15: +0 linesWeek of 2026-03-15: -0 linesWeek of 2026-03-22: +0 linesWeek of 2026-03-22: -0 linesWeek of 2026-03-29: +0 linesWeek of 2026-03-29: -0 linesWeek of 2026-04-05: +0 linesWeek of 2026-04-05: -0 linesWeek of 2026-04-12: +0 linesWeek of 2026-04-12: -0 linesWeek of 2026-04-19: +0 linesWeek of 2026-04-19: -0 linesWeek of 2026-04-26: +0 linesWeek of 2026-04-26: -0 linesWeek of 2026-05-03: +0 linesWeek of 2026-05-03: -0 linesWeek of 2026-05-10: +1 linesWeek of 2026-05-10: -1 linesWeek of 2026-05-17: +123 linesWeek of 2026-05-17: -88 linesWeek of 2026-05-24: +107 linesWeek of 2026-05-24: -18 linesWeek of 2026-05-31: +956 linesWeek of 2026-05-31: -418 linesWeek of 2026-06-07: +493 linesWeek of 2026-06-07: -350 linesWeek of 2026-06-14: +826 linesWeek of 2026-06-14: -502 linesWeek of 2026-06-21: +0 linesWeek of 2026-06-21: -0 linesWeek of 2026-06-28: +0 linesWeek of 2026-06-28: -0 linesWeek of 2026-07-05: +0 linesWeek of 2026-07-05: -0 linesWeek of 2026-07-12: +949 linesWeek of 2026-07-12: -559 linesWeek of 2026-07-19: +339 linesWeek of 2026-07-19: -109 linesWeek of 2026-07-26: +0 linesWeek of 2026-07-26: -0 linesWeek of 2026-08-02: +132 linesWeek of 2026-08-02: -91 linesWeek of 2026-08-09: +259 linesWeek of 2026-08-09: -211 linesWeek of 2026-08-16: +6,687 linesWeek of 2026-08-16: -9,232 linesWeek of 2026-08-23: +0 linesWeek of 2026-08-23: -0 linesWeek of 2026-08-30: +142 linesWeek of 2026-08-30: -80 linesWeek of 2026-09-06: +576 linesWeek of 2026-09-06: -137 linesWeek of 2026-09-13: +412 linesWeek of 2026-09-13: -15 linesWeek of 2026-09-20: +0 linesWeek of 2026-09-20: -0 linesWeek of 2026-09-27: +1,052 linesWeek of 2026-09-27: -744 linesWeek of 2026-10-04: +1,815 linesWeek of 2026-10-04: -559 linesWeek of 2026-10-11: +253 linesWeek of 2026-10-11: -88 linesWeek of 2026-10-18: +198 linesWeek of 2026-10-18: -117 linesWeek of 2026-10-25: +179 linesWeek of 2026-10-25: -80 linesWeek of 2026-11-01: +56 linesWeek of 2026-11-01: -23 linesWeek of 2026-11-08: +762 linesWeek of 2026-11-08: -51 linesWeek of 2026-11-15: +0 linesWeek of 2026-11-15: -0 linesJan 18, 2026Nov 15, 2026
+22.9K lines added, -16.1K removed over the last year.

Commits per week

last 52 weeks
270Week of 2025-11-23: 0 commitsWeek of 2025-11-30: 0 commitsWeek of 2025-12-07: 0 commitsWeek of 2025-12-14: 0 commitsWeek of 2025-12-21: 0 commitsWeek of 2025-12-28: 0 commitsWeek of 2026-01-04: 0 commitsWeek of 2026-01-11: 0 commitsWeek of 2026-01-18: 5 commitsWeek of 2026-01-25: 6 commitsWeek of 2026-02-01: 8 commitsWeek of 2026-02-08: 2 commitsWeek of 2026-02-15: 5 commitsWeek of 2026-02-22: 0 commitsWeek of 2026-03-01: 3 commitsWeek of 2026-03-08: 0 commitsWeek of 2026-03-15: 0 commitsWeek of 2026-03-22: 0 commitsWeek of 2026-03-29: 0 commitsWeek of 2026-04-05: 0 commitsWeek of 2026-04-12: 0 commitsWeek of 2026-04-19: 0 commitsWeek of 2026-04-26: 0 commitsWeek of 2026-05-03: 0 commitsWeek of 2026-05-10: 1 commitsWeek of 2026-05-17: 3 commitsWeek of 2026-05-24: 1 commitsWeek of 2026-05-31: 7 commitsWeek of 2026-06-07: 12 commitsWeek of 2026-06-14: 9 commitsWeek of 2026-06-21: 0 commitsWeek of 2026-06-28: 0 commitsWeek of 2026-07-05: 0 commitsWeek of 2026-07-12: 5 commitsWeek of 2026-07-19: 3 commitsWeek of 2026-07-26: 0 commitsWeek of 2026-08-02: 3 commitsWeek of 2026-08-09: 8 commitsWeek of 2026-08-16: 27 commitsWeek of 2026-08-23: 0 commitsWeek of 2026-08-30: 5 commitsWeek of 2026-09-06: 1 commitsWeek of 2026-09-13: 4 commitsWeek of 2026-09-20: 0 commitsWeek of 2026-09-27: 11 commitsWeek of 2026-10-04: 13 commitsWeek of 2026-10-11: 9 commitsWeek of 2026-10-18: 8 commitsWeek of 2026-10-25: 4 commitsWeek of 2026-11-01: 1 commitsWeek of 2026-11-08: 1 commitsWeek of 2026-11-15: 0 commitsNov 23, 2025Nov 15, 2026
165 commits in the last 52 weeks.

When work happens

weekday and hour
SunMonTueWedThuFriSat036912151821Sun 0:00 — 2 commitsSun 1:00 — 1 commitsSun 2:00 — 0 commitsSun 3:00 — 0 commitsSun 4:00 — 0 commitsSun 5:00 — 1 commitsSun 6:00 — 0 commitsSun 7:00 — 0 commitsSun 8:00 — 0 commitsSun 9:00 — 0 commitsSun 10:00 — 0 commitsSun 11:00 — 0 commitsSun 12:00 — 0 commitsSun 13:00 — 0 commitsSun 14:00 — 0 commitsSun 15:00 — 0 commitsSun 16:00 — 1 commitsSun 17:00 — 0 commitsSun 18:00 — 0 commitsSun 19:00 — 2 commitsSun 20:00 — 0 commitsSun 21:00 — 0 commitsSun 22:00 — 0 commitsSun 23:00 — 0 commitsMon 0:00 — 1 commitsMon 1:00 — 0 commitsMon 2:00 — 0 commitsMon 3:00 — 0 commitsMon 4:00 — 0 commitsMon 5:00 — 0 commitsMon 6:00 — 0 commitsMon 7:00 — 0 commitsMon 8:00 — 0 commitsMon 9:00 — 2 commitsMon 10:00 — 0 commitsMon 11:00 — 4 commitsMon 12:00 — 2 commitsMon 13:00 — 3 commitsMon 14:00 — 0 commitsMon 15:00 — 2 commitsMon 16:00 — 2 commitsMon 17:00 — 5 commitsMon 18:00 — 0 commitsMon 19:00 — 0 commitsMon 20:00 — 0 commitsMon 21:00 — 3 commitsMon 22:00 — 0 commitsMon 23:00 — 1 commitsTue 0:00 — 0 commitsTue 1:00 — 0 commitsTue 2:00 — 0 commitsTue 3:00 — 0 commitsTue 4:00 — 0 commitsTue 5:00 — 0 commitsTue 6:00 — 0 commitsTue 7:00 — 0 commitsTue 8:00 — 0 commitsTue 9:00 — 1 commitsTue 10:00 — 0 commitsTue 11:00 — 1 commitsTue 12:00 — 1 commitsTue 13:00 — 1 commitsTue 14:00 — 0 commitsTue 15:00 — 0 commitsTue 16:00 — 0 commitsTue 17:00 — 5 commitsTue 18:00 — 5 commitsTue 19:00 — 10 commitsTue 20:00 — 2 commitsTue 21:00 — 6 commitsTue 22:00 — 0 commitsTue 23:00 — 1 commitsWed 0:00 — 0 commitsWed 1:00 — 0 commitsWed 2:00 — 0 commitsWed 3:00 — 0 commitsWed 4:00 — 0 commitsWed 5:00 — 0 commitsWed 6:00 — 0 commitsWed 7:00 — 0 commitsWed 8:00 — 0 commitsWed 9:00 — 0 commitsWed 10:00 — 0 commitsWed 11:00 — 1 commitsWed 12:00 — 0 commitsWed 13:00 — 0 commitsWed 14:00 — 3 commitsWed 15:00 — 0 commitsWed 16:00 — 1 commitsWed 17:00 — 1 commitsWed 18:00 — 2 commitsWed 19:00 — 7 commitsWed 20:00 — 4 commitsWed 21:00 — 2 commitsWed 22:00 — 0 commitsWed 23:00 — 1 commitsThu 0:00 — 0 commitsThu 1:00 — 0 commitsThu 2:00 — 0 commitsThu 3:00 — 0 commitsThu 4:00 — 0 commitsThu 5:00 — 0 commitsThu 6:00 — 0 commitsThu 7:00 — 3 commitsThu 8:00 — 3 commitsThu 9:00 — 1 commitsThu 10:00 — 0 commitsThu 11:00 — 2 commitsThu 12:00 — 2 commitsThu 13:00 — 1 commitsThu 14:00 — 6 commitsThu 15:00 — 6 commitsThu 16:00 — 2 commitsThu 17:00 — 3 commitsThu 18:00 — 3 commitsThu 19:00 — 3 commitsThu 20:00 — 0 commitsThu 21:00 — 2 commitsThu 22:00 — 0 commitsThu 23:00 — 0 commitsFri 0:00 — 1 commitsFri 1:00 — 0 commitsFri 2:00 — 0 commitsFri 3:00 — 2 commitsFri 4:00 — 0 commitsFri 5:00 — 0 commitsFri 6:00 — 0 commitsFri 7:00 — 0 commitsFri 8:00 — 0 commitsFri 9:00 — 0 commitsFri 10:00 — 0 commitsFri 11:00 — 1 commitsFri 12:00 — 0 commitsFri 13:00 — 2 commitsFri 14:00 — 1 commitsFri 15:00 — 1 commitsFri 16:00 — 1 commitsFri 17:00 — 6 commitsFri 18:00 — 2 commitsFri 19:00 — 2 commitsFri 20:00 — 3 commitsFri 21:00 — 2 commitsFri 22:00 — 0 commitsFri 23:00 — 0 commitsSat 0:00 — 0 commitsSat 1:00 — 0 commitsSat 2:00 — 0 commitsSat 3:00 — 0 commitsSat 4:00 — 0 commitsSat 5:00 — 0 commitsSat 6:00 — 0 commitsSat 7:00 — 0 commitsSat 8:00 — 1 commitsSat 9:00 — 0 commitsSat 10:00 — 0 commitsSat 11:00 — 2 commitsSat 12:00 — 1 commitsSat 13:00 — 0 commitsSat 14:00 — 1 commitsSat 15:00 — 1 commitsSat 16:00 — 0 commitsSat 17:00 — 0 commitsSat 18:00 — 5 commitsSat 19:00 — 1 commitsSat 20:00 — 3 commitsSat 21:00 — 0 commitsSat 22:00 — 2 commitsSat 23:00 — 0 commits
Commit volume by weekday and hour (UTC). Larger dots mean more commits.
DateListRankStars gained
Feb 2, 2026daily#16+174
Feb 1, 2026daily#12+216
Jan 31, 2026daily#16+171
  • affaan-m/ECC

    The agent harness performance optimization system. Skills, instincts, memory, security, and research-first development for Claude Code, Codex, Opencode, Cursor and beyond.

    307.9K stars · JavaScript

  • react/react

    The library for web and native user interfaces.

    252.8K stars · JavaScript

  • DietrichGebert/ponytail

    Makes your AI agent think like the laziest senior dev in the room. The best code is the code you never wrote.

    195.7K stars · JavaScript

  • vercel/next.js

    The React Framework

    143.6K stars · JavaScript

  • addyosmani/agent-skills

    Production-grade engineering skills for AI coding agents.

    119.4K stars · JavaScript

  • Leonxlnx/taste-skill

    Agent skills that give coding agents taste: art direction, reference images and a browser check instead of generic AI pages

    119.4K stars · JavaScript