Gemini CLI

Prérequis

Utilisez les outils de développement Gemini CLI avec sa configuration MCP validée dans settings.json et la prise en charge d'OAuth via le navigateur. La prise en charge s'applique à l'outil pour développeurs Gemini CLI et n'implique aucune intégration dans le chat Web grand public de Gemini (gemini.google.com) ni approbation officielle dans la galerie d'extensions.

• Point de terminaison : https://xmemo.dev/mcp.
• Mode d'authentification : OAuth.
• Fichier de configuration : ~/.gemini/settings.json.
• Transport : Streamable HTTP (httpUrl pour le point de terminaison hébergé).
• Dépôt de l'extension : github:yonro/xmemo-gemini-cli (manifeste 0.1.0 ; installation documentée depuis GitHub, aucune approbation officielle déduite).

Installation / configuration

Installez l'extension à l'aide de la commande d'extensions Gemini CLI, ou fusionnez manuellement le bloc de configuration XMemo dans ~/.gemini/settings.json sous mcpServers.

• Commande d'extension : gemini extensions install https://github.com/yonro/xmemo-gemini-cli (ancrée sur yonro/xmemo-gemini-cli @ 39e25b185b README).
• Solution de repli manuelle : fusionnez le bloc XMemo dans ~/.gemini/settings.json, en conservant httpUrl et les en-têtes d'identité.

gemini extensions install https://github.com/yonro/xmemo-gemini-cli

Configurer l'identifiant

Aucune clé requise — complétez l'authentification OAuth dans le navigateur après avoir redémarré Gemini CLI. Ne placez pas XMEMO_KEY ni d'en-tête Authorization dans settings.json.

No XMEMO_KEY
Complete browser OAuth in Gemini CLI

Générer / confirmer XMEMO_AGENT_INSTANCE_ID

Générez une valeur non secrète par installation locale de Gemini CLI, conservez-la en dehors de git et réutilisez-la après chaque redémarrage afin de garantir la stabilité de l'attribution.

export XMEMO_AGENT_INSTANCE_ID='<stable-local-instance-id>'

Conserver le bloc de configuration existant

Utilisez le bloc de configuration XMemo pour Gemini CLI rendu sur cette page. Conservez httpUrl et les en-têtes d'identité non secrets ; n'ajoutez ni Authorization ni XMEMO_KEY.

{
  "mcpServers": {
    "XMemo": {
      "httpUrl": "https://xmemo.dev/mcp",
      "headers": {
        "X-Memory-OS-Agent-ID": "gemini-cli",
        "X-Memory-OS-Agent-Instance-ID": "${XMEMO_AGENT_INSTANCE_ID}"
      }
    }
  }
}

Redémarrer le client

Redémarrez Gemini CLI après avoir enregistré settings.json afin qu'il charge le endpoint ainsi que l'identité d'instance actuelle, puis complétez le consentement OAuth.

Tester avec un appel de rappel (recall) réel

Effectuez le premier appel MCP en lecture seule. Il s'agit d'une véritable invocation de recall, et non d'un simple indicateur de contrôle d'état (health check) ; cette opération n'écrit aucune mémoire.

recall({ query: "connection check", limit: 1 })

Réponse attendue (format littéral)

Un appel réussi renvoie le format de texte classé public ci-dessous ; la référence et le contenu sont des valeurs réelles issues de l'espace de mémoire autorisé.

### XMemo Memory Results:
1. Reference: <opaque-memory-id> | Location: <location>
   > <memory content>

Erreurs fréquentes

Les échecs OAuth de Gemini CLI reposent sur le contrat d'erreur OAuth hébergé.

• invalid_grant — Le code d'autorisation OAuth est invalide, expiré ou a déjà été utilisé : reconnectez Gemini CLI et autorisez à nouveau.
• invalid_target — La ressource OAuth ne correspond pas à ce serveur MCP : utilisez https://xmemo.dev/mcp et reconnectez-vous.
• 403 insufficient_scope — L'autorisation n'inclut pas memory:read : approuvez le périmètre requis et reconnectez-vous.