{
  "markdown": "# Claude-Supermemory\n\n<img width=\"4000\" height=\"2130\" alt=\"image (6)\" src=\"https://github.com/user-attachments/assets/07e63ac4-b67d-457b-9029-1dc5d860e920\" />\n\nA Claude Code plugin that gives your AI persistent memory across sessions using [Supermemory](https://supermemory.ai).\nYour agent remembers what you worked on - across sessions, across projects.\n\n## Features\n\n- **Team Memory** — Project knowledge shared across your team, separate from personal memories\n- **Auto Capture** — Conversations saved when session ends\n- **Project Config** — Per-repo settings, API keys, and container tags\n\n## Installation\n\n> **Requires Node.js 18+** on your PATH — the memory hooks run as Node scripts.\n\n```bash\n/plugin marketplace add supermemoryai/claude-supermemory\n/plugin install supermemory\n```\n\n> **Already have the old `claude-supermemory` plugin installed?** It was renamed to `supermemory`, so it won't update in place. Migrate with:\n>\n> ```bash\n> /plugin marketplace update supermemory-plugins\n> /plugin install supermemory@supermemory-plugins\n> ```\n>\n> Then, **only if you still have the old plugin**, remove it:\n>\n> ```bash\n> /plugin uninstall claude-supermemory@supermemory-plugins\n> ```\n\nSet your API key (get one at [console.supermemory.ai](https://console.supermemory.ai)):\n\n```bash\nexport SUPERMEMORY_CC_API_KEY=\"sm_...\"\n```\n\n## How It Works\n\n- **Reasoned recall** — Before each turn, Claude decides whether recalling memory would actually help your current message, and only searches when it's worth it — every turn, once in a while, or not at all. The search runs automatically (no permission prompt), just like auto-capture. Searching only when needed also keeps more usage on your plan\n- **supermemory-search** — Ask about past work or previous sessions, Claude searches your memories\n- **supermemory-save** — Ask to save something important, Claude saves it for the team\n\n### Shared Agents memory\n\nClaude Code, Codex, and OpenCode use one container for a repository:\n\n- `repo_<project-name>__<remote-hash>` stores automatic capture and every explicit save.\n- `sm_scope` metadata keeps personal and project memories filterable inside that container.\n\nThe hash is derived from the normalized Git remote, so clones share memory while\nsame-named repositories do not collide. Repositories without a remote fall back to\na local path identity. The agent plugins also read the previous `user_project_*`,\n`repo_<project-name>`, `claudecode_project_*`, `codex_user_*`,\n`codex_project_*`, `opencode_user_*`, and `opencode_project_*` containers, so\nexisting memories remain searchable without a migration. Set\n`SUPERMEMORY_ISOLATE_WORKTREES=true` to use the worktree path instead of the\nremote identity.\n\nExplicit `repoContainerTag`/`projectContainerTag` overrides remain the canonical\nwrite destination. Older personal/user overrides remain in the legacy read set.\n\n## Commands\n\n| Command                              | Description                              |\n| ------------------------------------ | ---------------------------------------- |\n| `/supermemory:index`          | Index codebase architecture and patterns |\n| `/supermemory:project-config` | Configure project-level settings         |\n| `/supermemory:logout`         | Clear saved credentials                  |\n| `/supermemory:session`        | Show clickable URL for the current session document in Supermemory |\n| `/supermemory:status`         | Show authentication status |\n\n## Configuration\n\n**Environment**\n\n```bash\nSUPERMEMORY_CC_API_KEY=sm_...    # Required\nSUPERMEMORY_DEBUG=true           # Optional: enable debug logging\n```\n\n**Global Settings** — `~/.supermemory-claude/settings.json`\n\n```json\n{\n  \"maxProfileItems\": 5,\n  \"signalExtraction\": true,\n  \"signalKeywords\": [\"remember\", \"architecture\", \"decision\", \"bug\", \"fix\"],\n  \"signalTurnsBefore\": 3,\n  \"includeTools\": [\"Edit\", \"Write\"]\n}\n```\n\n| Option              | Description                                   |\n| ------------------- | --------------------------------------------- |\n| `maxProfileItems`   | Max memories in context (default: 5)          |\n| `recallDirective`   | Override the built-in reasoned-recall instruction Claude is given |\n| `signalExtraction`  | Only capture important turns (default: false) |\n| `signalKeywords`    | Keywords that trigger capture                 |\n| `signalTurnsBefore` | Context turns before signal (default: 3)      |\n| `includeTools`      | Tools to explicitly capture                   |\n\n**Project Config** — `.claude/.supermemory-claude/config.json`\n\nPer-repo overrides. Run `/supermemory:project-config` or create manually:\n\n```json\n{\n  \"apiKey\": \"sm_...\",\n  \"baseUrl\": \"https://api.supermemory.ai\",\n  \"repoContainerTag\": \"my-team-project\",\n  \"signalExtraction\": true\n}\n```\n\n| Option                 | Description                 |\n| ---------------------- | --------------------------- |\n| `apiKey`               | Project-specific API key    |\n| `baseUrl`              | Supermemory API URL    |\n| `personalContainerTag` | Legacy personal container retained for reads |\n| `repoContainerTag`     | Override unified project container tag |\n\n## Privacy\n\nFor information about how Supermemory collects, uses, and retains data, see the\n[Supermemory Privacy Policy](https://supermemory.ai/privacy/).\n\n## License\n\nMIT\n",
  "bytes": 5296,
  "sha": "6f3a526763bea0c574d9f63c3bf67ed5cf7b56184ae430329b6ece5321a88c83",
  "repo_slug": "supermemoryai/claude-supermemory",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/skl_supermemoryai_claude_supermemory_super_s_566366fb/readme"
}