Extensions Officielles Gemini CLI

Ce que contient ce pack

Ce pack reproduit les dix extensions officielles que Google publie pour Gemini CLI sur le repo google-gemini/gemini-cli. Chaque entrée est une release first-party — pas de forks communautaires, pas de mirrors à moitié maintenus. Si Google déprécie une extension upstream, nous suivons dans le cycle de release suivant.

Pourquoi les extensions Gemini CLI comptent

La killer feature de Gemini CLI est son contexte de 1M tokens — mais le contexte brut est inutile sans surfaces typées à appeler. Les extensions sont la façon dont Gemini CLI obtient des types : chacune déclare ses outils, schémas, et chemins de credentials pour que l'agent ne devine pas comment appeler votre warehouse ou votre fichier Figma. Elles sont la réponse de Google à la couche subagents Claude Code et à la couche serveurs MCP en même temps : plus serrées que MCP parce qu'elles embarquent une UX spécifique Gemini, plus légères que les subagents parce qu'elles n'ont pas besoin de prompt séparé.

Les cinq ancres que les équipes utilisent au quotidien :

• Stitch est la plus démontrée. Lâchez une URL Figma ou un screenshot, et Gemini émet du React/Vue/Tailwind prêt pour la prod. La sortie est une vraie PR, pas un prop Storybook.
• Workspace vous laisse générer un doc, remplir une feuille, ou éditer des slides depuis le terminal. Utile pour les status reports et la prep de réunion.
• Code Review lance une passe de revue structurée contre un diff ou une branche — commentaires regroupés par sévérité, avec ancres fichier/ligne.
• Postgres ouvre un pool de connexions, exécute des queries en lecture-seule par défaut, et laisse l'agent introspecter le schéma avant d'écrire du SQL.
• Vertex AI compte quand vous ne pouvez pas envoyer code ou data à l'endpoint Gemini public. Le routage via Vertex garde tout dans votre projet GCP, votre IAM, vos audit logs.

Installer en une commande

# Installer le pack entier
tokrepo install pack/gemini-cli-extensions

# Ou choisir une seule extension
tokrepo install gemini-stitch
tokrepo install gemini-vertex-ai

Le TokRepo CLI écrit les bonnes entrées dans ~/.gemini/extensions.json et enregistre le manifeste de chaque extension. Pas d'édition JSON à la main, pas de chasse à l'ordre d'installation dans des blog posts. Lancez tokrepo uninstall <slug> pour retirer proprement.

Pièges courants

• Drift de scopes auth. Workspace et Vertex AI demandent des scopes OAuth différents. Installez les deux dans la même session avec gcloud auth login --update-adc à jour ; sinon la seconde installation héritera silencieusement des scopes de la première et échouera au premier appel.
• Rate limit Figma pour Stitch. Le plan free Figma limite les appels API par minute. Traitez les grandes pages en lots ou vous verrez des sets de composants partiels et devrez réessayer.
• Postgres est lecture-seule par défaut. Les mutations demandent --allow-write explicite. C'est une feature : ça stoppe les prompts accidentels de DROP TABLE. Activez par session, jamais en global.
• Surprise de facturation Vertex AI. Le routage via Vertex transforme chaque appel Gemini en requête facturée sur votre projet GCP, même si vous aviez du quota sur l'endpoint public. Configurez une alerte budget avant d'installer.
• Search Grounding verrouillé par région. Quelques extensions retournent des chunks de grounding vides dans les régions EU à cause des flags de consentement. Vérifiez la matrice de support par extension sur le repo upstream avant de dépendre du grounding pour les flux de conformité.

Relation avec les autres packs

Ce pack est le côté Gemini CLI d'une histoire en trois packs : extensions Gemini CLI ici, subagents Claude Code dans claude-code-subagents, et serveurs MCP cross-tool dans mcp-server-stack. Si vous vivez dans Gemini CLI, installez celui-ci. Si vous changez d'outil chaque semaine, installez les serveurs MCP — ils survivent à la transition.