Gemini CLI

Qué es

Gemini CLI es el agente de línea de comandos oficial de Google para la familia de modelos Gemini. Lanzado open source bajo Apache-2.0 en 2025, te da un agente residente en terminal capaz de leer archivos, ejecutar comandos shell, navegar web vía Google Search y montar extensiones de primera mano de Google encima — Stitch, Google Workspace, Code Review, Postgres, Vertex AI y más.

Es la herramienta a la que recurrir cuando:

• Quieres una capa gratuita generosa — Gemini CLI viene con una cuota gratuita real de Gemini API que cubre cómoda los loops diarios de coding.
• Ya vives en Google Cloud / Workspace y quieres MCP de primera mano hacia Vertex, BigQuery, Drive, Calendar.
• Quieres un agente terminal que también sea bueno en multimodal — Gemini 2.5 / 3 maneja imágenes y video nativamente, y el CLI lo expone.

Por qué destaca

Cómo instalar

# macOS / Linux / WSL
npm install -g @google/gemini-cli

# O vía Homebrew
brew install gemini-cli

Tras instalar, corre gemini en cualquier proyecto. El primer run pide login con cuenta Google o variable GEMINI_API_KEY. La capa gratuita arranca al instante; cambia a Vertex para SSO y audit logs en contextos enterprise.

Qué instalar dentro de Gemini CLI

Gemini CLI tiene su propio manifest de extensiones (~/.gemini/extensions.json) más soporte MCP genérico. Tres packs TokRepo para empezar:

• Stack de Servidores MCP — servers Postgres / GitHub / Filesystem que funcionan cross-tool
• Toolkit MCP de Google Cloud — Vertex AI, BigQuery, Cloud Run cableado en Gemini CLI
• Multimodal Workflow Pack — image-to-Stitch, pipelines de transcript de video optimizadas para Gemini 3

Instala con tokrepo install y tienes paridad con lo que los equipos internos de Google han estado demostrando.

Errores comunes

• No fijar el modelo — Gemini CLI usa "latest" por defecto, que puede moverse sin aviso. Pon GEMINI_MODEL=gemini-2.5-pro en .env para runs reproducibles.
• Rate limits de capa gratuita en loops largos — el throttle de burst pega a ~60 req/min. Añade backoff o cambia a proyecto Vertex de pago.
• Mezclar login OAuth con CI — el login interactivo no funciona en headless. Usa service-account key y GEMINI_API_KEY.
• Scope de permisos de extensiones — las extensiones Workspace y Calendar leen tu inbox / calendario completos. Audita ~/.gemini/extensions.json antes de compartir el directorio.
• Coste de Search grounding — cada respuesta grounded cuenta contra la cuota de Search API por separado de los tokens Gemini.

Relación con otras herramientas

Gemini CLI es la respuesta de Google a Claude Code y Codex CLI. El diferencial a tres: Claude Code gana en calidad pura de agente (Opus 4.7 + el ecosistema subagent más maduro); Codex CLI gana en adopción del convenio AGENTS.md; Gemini CLI gana en capa gratuita, multimodal e integración con Google Cloud. La mayoría de devs senior en 2026 mantienen los tres instalados y eligen por tarea — Gemini para spec-desde-captura, Claude para refactors largos, Codex cuando se empareja con ChatGPT Pro.