Gemini CLI 0.32.1

Gemini CLI es un agente de IA de código abierto que lleva la potencia de Gemini directamente a tu terminal. Proporciona un acceso ligero a Gemini, ofreciéndote el camino más directo desde tu prompt hasta el modelo de Google.

¿Por qué Gemini CLI?

• Nivel gratuito: 60 solicitudes/min y 1.000 solicitudes/día con una cuenta personal de Google.
• Modelos Gemini 3 potentes: Acceso a razonamiento mejorado y una ventana de contexto de 1M de tokens.
• Herramientas integradas: Búsqueda en Google (grounding), operaciones de archivos, comandos de shell y obtención de datos web.
• Extensible: Soporte de MCP (Model Context Protocol) para integraciones personalizadas.
• Terminal-first: Diseñado para desarrolladores que viven en la línea de comandos.
• Código abierto: Licencia Apache 2.0.

Instalación

Requisitos previos antes de la instalación

• Node.js versión 20 o superior.
• macOS, Linux o Windows.

Instalación rápida

Ejecuta instantáneamente con npx:

npx @google/gemini-cli (no requiere instalación).

Instalar globalmente con npm:

npm install -g @google/gemini-cli

Instalar globalmente con Homebrew (macOS/Linux):

brew install gemini-cli

Instalar globalmente con MacPorts (macOS):

sudo port install gemini-cli

Instalar con Anaconda (para entornos restringidos):

# Crea y activa un nuevo entorno
conda create -y -n gemini_env -c conda-forge nodejs
conda activate gemini_env
# Instala Gemini CLI globalmente vía npm (dentro del entorno)
npm install -g @google/gemini-cli

Características clave

Comprensión y generación de código

• Consulta y edita grandes bases de código.
• Genera nuevas aplicaciones a partir de PDFs, imágenes o bocetos utilizando capacidades multimodales.
• Depura problemas y soluciona errores con lenguaje natural.

Automatización e integración

• Automatiza tareas operativas como consultar pull requests o gestionar rebases complejos.
• Usa servidores MCP para conectar nuevas capacidades, incluyendo la generación de medios con Imagen, Veo o Lyria.
• Ejecuta de forma no interactiva en scripts para la automatización de flujos de trabajo.

Capacidades avanzadas

• Fundamenta tus consultas con la búsqueda integrada de Google para obtener información en tiempo real.
• Puntos de control de conversación para guardar y reanudar sesiones complejas.
• Archivos de contexto personalizados (GEMINI.md) para adaptar el comportamiento a tus proyectos.

Integración con GitHub

Integra Gemini CLI directamente en tus flujos de trabajo de GitHub con la Gemini CLI GitHub Action:

• Revisiones de Pull Request: Revisión de código automatizada con comentarios y sugerencias contextuales.
• Triaje de Issues: Etiquetado y priorización automática de incidencias basado en el análisis de contenido.
• Asistencia bajo demanda: Menciona a @gemini-cli en issues y pull requests para ayuda con depuración, explicaciones o delegación de tareas.
• Flujos personalizados: Crea flujos de trabajo automatizados, programados o bajo demanda adaptados a las necesidades de tu equipo.

Opciones de autenticación

Elige el método que mejor se adapte a tus necesidades:

Opción 1: Iniciar sesión con Google (OAuth)

Ideal para desarrolladores individuales y usuarios con licencia de Gemini Code Assist.

• Beneficios: Nivel gratuito (60 req/min, 1.000 req/día), modelos Gemini 3 con 1M de tokens, sin gestión de claves API y actualizaciones automáticas.
• Uso: Inicia Gemini CLI, elige "Login with Google" y sigue el flujo en el navegador.

Opción 2: Clave de API de Gemini

Ideal para desarrolladores que necesitan control específico del modelo o acceso de pago.

• Beneficios: 1.000 solicitudes/día con Gemini 3 (mezcla de Flash y Pro), selección de modelos específicos y facturación por uso.
• Configuración: export GEMINI_API_KEY="TU_API_KEY"

Opción 3: Vertex AI

Ideal para equipos empresariales y cargas de trabajo de producción.

• Beneficios: Seguridad y cumplimiento avanzados, mayor escalabilidad e integración con la infraestructura de Google Cloud.
• Configuración: export GOOGLE_API_KEY="TU_API_KEY" y export GOOGLE_GENAI_USE_VERTEXAI=true

Primeros pasos

Uso básico

Iniciar en el directorio actual:

gemini

Incluir múltiples directorios:

gemini --include-directories ../lib,../docs

Usar un modelo específico:

gemini -m gemini-2.5-flash

Modo no interactivo para scripts:

gemini -p "Explica la arquitectura de esta base de código"

Para scripting avanzado, usa la bandera --output-format json para obtener una salida estructurada, o --output-format stream-json para eventos JSON delimitados por nuevas líneas en tiempo real.

Ejemplos rápidos

Comenzar un nuevo proyecto:

cd nuevo-proyecto/
gemini> Escríbeme un bot de Discord que responda preguntas usando un archivo FAQ.md que te proporcionaré.

Analizar código existente:

git clone https://github.com/google-gemini/gemini-cli
cd gemini-cli
gemini> Dame un resumen de todos los cambios que se introdujeron ayer.

Gemini CLI ha sido creado por Google y la comunidad Open Source.