{
  "markdown": "# XMemo for Gemini CLI\n\n[![Gemini CLI Extension](https://img.shields.io/badge/Gemini%20CLI-extension-blue)](https://geminicli.com/extensions/browse/)\n\n**XMemo** gives Gemini CLI a persistent, user-owned long-term memory. Store and recall\nfacts, preferences, decisions, and project context across sessions — and share the same\nmemory with every AI tool you use (ChatGPT, Claude, Copilot, IDEs, and more).\n\nXMemo is **user-owned**: you control, view, edit, and delete your memories at\n[xmemo.dev](https://xmemo.dev).\n\n## Install\n\n```bash\ngemini extensions install https://github.com/yonro/xmemo-gemini-cli\n```\n\nAfter installing, **restart your Gemini CLI session** so the extension loads.\n\n## Sign in (OAuth — no token needed)\n\nXMemo uses **automatic OAuth**. The first time the `memory_os` tools are used,\nGemini CLI detects the `401` from `https://xmemo.dev/mcp`, discovers XMemo's OAuth\nendpoints, registers a client, and opens your browser to sign in. Your tokens are\nstored securely by Gemini CLI for future sessions — **no API key to copy or paste.**\n\n> Prefer an API token instead? You can add `\"Authorization\": \"Bearer <token>\"` to\n> the `headers` block manually, but OAuth is the recommended, zero-secret path.\n\n## What you get\n\n- A `memory_os` MCP server connected to `https://xmemo.dev/mcp`.\n- Tools to **search**, **add**, and **update** memories from inside Gemini CLI.\n- A `GEMINI.md` playbook that teaches the model when to store and recall memories.\n\n## How it works\n\n| Field | Value |\n| --- | --- |\n| Transport | Remote HTTP MCP (`httpUrl`) |\n| Endpoint | `https://xmemo.dev/mcp` |\n| Auth | Automatic OAuth 2.0 (RFC 9728 discovery + dynamic client registration + PKCE) |\n| Agent label | `X-Memory-OS-Agent-ID: gemini-cli` (so memories are attributed to this client) |\n\nOAuth authenticates **you** (the memory owner). The `X-Memory-OS-Agent-ID` header is\na label that tells XMemo which client wrote a memory — it is attribution, not a\nsecurity boundary. Your OAuth identity is the security boundary.\n\n## Manage the extension\n\n```bash\ngemini extensions list\ngemini extensions update xmemo\ngemini extensions disable xmemo\ngemini extensions uninstall xmemo\n```\n\n## Privacy\n\n- Authentication uses OAuth; tokens are managed by Gemini CLI, not stored in this repo.\n- No host environment variables are forwarded to the server.\n- You can delete any memory at any time from [xmemo.dev](https://xmemo.dev).\n\n## Links\n\n- Website: https://xmemo.dev\n- MCP endpoint: https://xmemo.dev/mcp\n\n## License\n\nMIT — see [LICENSE](LICENSE).\n",
  "bytes": 2532,
  "sha": "4b3569794331082262642d57543d03784da1838c4177f18d23086000d022fc94",
  "repo_slug": "yonro/xmemo-gemini-cli",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/plg_yonro_xmemo_gemini_cli_be220eb7/readme"
}