Extensiones Oficiales de Gemini CLI

Qué incluye este pack

Este pack reproduce las diez extensiones oficiales que Google publica para Gemini CLI en el repo google-gemini/gemini-cli. Cada entrada es un release de primera parte — sin forks comunitarios, sin mirrors a medio mantener. Si Google la deprecia upstream, seguimos en el siguiente ciclo.

Por qué importan las extensiones de Gemini CLI

La feature estrella de Gemini CLI es su contexto de 1M tokens — pero el contexto crudo es inútil sin superficies tipadas para llamar. Las extensiones son cómo Gemini CLI obtiene tipos: cada una declara herramientas, esquemas y rutas de credenciales para que el agente no adivine cómo llamar a tu warehouse o a tu archivo Figma. Son la respuesta de Google a la capa de subagentes de Claude Code y la capa de servidores MCP a la vez: más ajustadas que MCP porque traen UX específica de Gemini, más livianas que subagentes porque no necesitan prompt aparte.

Las cinco anclas que los equipos usan a diario:

• Stitch es la más demostrada. Suelta una URL de Figma o un screenshot y Gemini emite React/Vue/Tailwind listo para producción. La salida es un PR real, no un prop de Storybook.
• Workspace te deja generar un doc, llenar una hoja o editar slides desde terminal. Útil para reportes de estado y prep de reuniones.
• Code Review corre una pasada estructurada contra un diff o rama — comentarios por severidad, con anclas archivo/línea.
• Postgres abre un pool de conexiones, corre queries de solo-lectura por defecto, y deja al agente reflejar el esquema antes de escribir SQL.
• Vertex AI importa cuando no puedes mandar código o datos al endpoint público de Gemini. Rutear por Vertex deja todo dentro de tu proyecto GCP, tu IAM, tus audit logs.

Instala en un comando

# Instala el pack completo
tokrepo install pack/gemini-cli-extensions

# O elige una sola extensión
tokrepo install gemini-stitch
tokrepo install gemini-vertex-ai

El TokRepo CLI escribe las entradas correctas en ~/.gemini/extensions.json y registra el manifiesto de cada extensión. Sin editar JSON a mano, sin perseguir el orden de instalación en blog posts. Usa tokrepo uninstall <slug> para retirar limpiamente.

Trampas comunes

• Drift de scopes de auth. Workspace y Vertex AI requieren scopes OAuth distintos. Instala ambas en la misma sesión con gcloud auth login --update-adc ya actualizado; si no, la segunda instalación heredará silenciosamente los scopes de la primera y fallará en la primera llamada.
• Rate limit de Figma para Stitch. El plan free de Figma limita llamadas API por minuto. Procesa páginas grandes en lotes o verás conjuntos parciales de componentes y tendrás que reintentar.
• Postgres es solo-lectura por defecto. Las mutaciones requieren --allow-write explícito. Es feature: detiene prompts accidentales de DROP TABLE. Activa por sesión, nunca global.
• Sorpresa de billing en Vertex AI. Rutear por Vertex convierte cada llamada Gemini en un request facturado a tu proyecto GCP, aunque tuvieras cuota en el endpoint público. Configura alerta de presupuesto antes de instalar.
• Search Grounding bloqueado por región. Algunas extensiones devuelven chunks vacíos en regiones EU por flags de consentimiento. Revisa la matriz de soporte por extensión en el repo upstream antes de depender de grounding para flujos de cumplimiento.

Relación con otros packs

Este pack es el lado Gemini CLI de una historia de tres packs: extensiones Gemini CLI aquí, subagentes Claude Code en claude-code-subagents, y servidores MCP cross-tool en mcp-server-stack. Si vives en Gemini CLI, instala éste. Si cambias de herramienta cada semana, instala los servidores MCP — sobreviven a la transición.