{
  "markdown": "# Gemini-Supermemory\n\n![Gemini-Supermemory Logo](readme_logo.png)\n\nA [Gemini CLI](https://github.com/google-gemini/gemini-cli) extension 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- **Persistent Memory** — Memories saved across sessions, automatically loaded when you start\n- **Team Memory** — Project knowledge shared across your team, separate from personal memories\n- **Auto Capture** — Sessions saved automatically when they end\n- **Auto Load** — Past context injected when a new session starts\n- **Codebase Indexing** — Deep-scan a repo's architecture and save it to memory\n- **Project Config** — Per-repo settings and container tag overrides\n\n## Installation\n\n```bash\ngemini extensions install https://github.com/Rishabjs03/gemini-supermemory\n```\n\nSet your API key when prompted (get one at [app.supermemory.ai](https://app.supermemory.ai)).\n\n## How It Works\n\nYour extension exposes **3 MCP tools** that Gemini calls automatically:\n\n| Tool | Description |\n| --- | --- |\n| `search_memory` | Search past memories and coding sessions |\n| `add_memory` | Save personal memories (decisions, preferences, learnings) |\n| `save_project_memory` | Save team/project knowledge (architecture, conventions) |\n\nPlus **two lifecycle hooks** that run behind the scenes:\n\n| Hook | Trigger | What it does |\n| --- | --- | --- |\n| **SessionStart** | Session begins | Fetches your past memories and injects them as context |\n| **SessionEnd** | Session ends | Saves a summary of the session to Supermemory |\n\n## Commands\n\n| Command | Description |\n| --- | --- |\n| `/index` | Index codebase architecture and patterns into Supermemory |\n\n## Configuration\n\n**API Key** — Set during installation, stored securely in system keychain.\n\nTo update it:\n```bash\ngemini extensions config gemini-supermemory\n```\n\nOr set via environment variable:\n```bash\nexport SUPERMEMORY_API_KEY=\"sm_...\"\n```\n\n---\n\n**Project Config** — Create `.gemini/.supermemory/config.json` in your repo root:\n\n```json\n{\n  \"apiKey\": \"sm_...\",\n  \"personalContainerTag\": \"my-personal-tag\",\n  \"repoContainerTag\": \"my-team-project\"\n}\n```\n\n| Option | Description |\n| --- | --- |\n| `apiKey` | Project-specific API key |\n| `personalContainerTag` | Override personal memory container |\n| `repoContainerTag` | Override team memory container |\n\n## Examples\n\n**Search memories:**\n> \"What did I work on yesterday?\"\n> \"How did we implement auth?\"\n\n**Save memories:**\n> \"Remember that I prefer ESM imports over CommonJS\"\n> \"Save project knowledge: this project uses MCP for tool integration\"\n\n**Index codebase:**\n> `/index`\n\n## Architecture\n\n```\ngemini-supermemory/\n├── gemini-extension.json    ← Extension manifest\n├── GEMINI.md                ← Context instructions for Gemini\n├── hooks/\n│   └── hooks.json           ← SessionStart/End hook config\n├── commands/\n│   └── index.toml           ← /index codebase scanning command\n└── src/\n    ├── server.js             ← MCP server (3 tools)\n    ├── hooks/\n    │   ├── session-start.js  ← Auto-load memories\n    │   └── session-end.js    ← Auto-save sessions\n    └── lib/\n        ├── supermemory-client.js  ← Supermemory SDK wrapper\n        ├── container-tag.js       ← Container tag generation\n        ├── config.js              ← Global config loader\n        ├── project-config.js      ← Per-repo config loader\n        ├── format-context.js      ← Memory formatting\n        ├── error-helper.js        ← Error handling\n        ├── git-utils.js           ← Git helpers\n        └── validate.js            ← Input validation\n```\n\n## Development\n\n```bash\n# Clone and install\ngit clone https://github.com/Rishabjs03/gemini-supermemory.git\ncd gemini-supermemory\nnpm install\n\n# Link for local development\ngemini extensions link .\n```\n\n## License\n\nMIT\n# memory-x\n# memory-x\n# memory-x\n",
  "bytes": 3904,
  "sha": "8f2fd8d5e627449807cc0b84aa296ce344b307024276d4b86cb66d3a13af6580",
  "repo_slug": "xucongyong/memory-x",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/plg_xucongyong_memory_x_77a5bdc4/readme"
}