Gemini CLI es la interfaz de línea de comandos oficial de Google diseñada para integrar agentes de IA multimodales directamente en el flujo de trabajo del desarrollador. A diferencia de un simple wrapper, esta herramienta actúa como un agente autónomo capaz de gestionar el contexto del proyecto local mediante archivos `GEMINI.md`, interactuar con servidores MCP (Model Context Protocol), ejecutar comandos de shell de forma segura y persistir información en una memoria de largo plazo. Esta guía avanzada para 2026 explora el uso de 'skills' personalizadas, la automatización de pipelines con modo headless, el control granular de sesiones con checkpoints y la optimización de costos mediante token caching, permitiendo transformar la terminal en un entorno de desarrollo cognitivo de alto rendimiento.

“Hola, mundo” en Gemini CLI

El 'Hola, mundo' avanzado con Gemini CLI: Instalación global, autenticación y la inicialización de un entorno de proyecto para que la IA comprenda el contexto local de forma automática.

📋 Copiar

# 1. Instalación mediante gestor de paquetes
npm install -g @google/gemini-cli

# 2. Autenticación segura con Google Cloud / AI Studio
gemini /auth login

# 3. Inicializar el contexto del repositorio actual
gemini /init

# 4. Primera consulta contextual
gemini "¿Qué tecnologías utiliza este proyecto y cómo puedo optimizar el Dockerfile?"

Resultado:

Output

El CLI analizará el árbol de directorios, leerá los archivos de configuración y devolverá un análisis técnico detallado integrando el conocimiento del modelo con los archivos locales.

Comandos básicos

Familiarizarse con estos comandos es esencial para interactuar eficientemente con Gemini CLI:

Control de Sesiones y Checkpointing
📋 Copiar
```
gemini /resume     # Recuperar la última sesión de trabajo
gemini /checkpoint # Crear un snapshot del estado actual del agente
gemini /rewind     # Volver a un estado anterior de la conversación
```
Permite gestionar estados complejos en conversaciones largas. Los checkpoints aseguran que, si una serie de comandos de shell fallan, el agente pueda restaurar el contexto previo sin perder tokens.
Ejecución de Shell y Sandboxing
📋 Copiar
```
gemini "Actualiza las dependencias y corre los tests" --execute
gemini /shells # Listar procesos y tareas en ejecución por el agente
```
El agente puede proponer y, bajo autorización, ejecutar comandos de terminal. En flujos avanzados, esto se realiza en entornos aislados para garantizar la integridad del sistema.
Gestión de Memoria y Contexto Persistente
📋 Copiar
```
gemini /memory add "El entorno de producción usa Kubernetes v1.30"
gemini /memory list
gemini /init --project-context "GEMINI.md"
```
Configura hechos que el modelo siempre recordará en futuras sesiones. El archivo `GEMINI.md` sirve como la 'biblia' del proyecto para el agente, definiendo reglas de estilo y arquitectura.
Orquestación con MCP (Model Context Protocol)
📋 Copiar
```
gemini /mcp add postgres-server
gemini "Consulta los últimos 5 usuarios registrados en la DB"
```
Conecta la CLI con fuentes de datos externas o herramientas de terceros que soporten el protocolo MCP, permitiendo que la IA interactúe con bases de datos, APIs de Slack, Jira o GitHub de forma nativa.
Búsqueda Web y Grounding en Tiempo Real
📋 Copiar
```
gemini "¿Cuál es la última vulnerabilidad reportada en OpenSSL?" --web
gemini /fetch https://docs.google.com/internal-spec
```
Habilita la capacidad de búsqueda en Google Search para evitar alucinaciones en temas de actualidad y permite extraer contenido de URLs específicas para análisis inmediato.
Modo Headless para Automatización CI/CD
📋 Copiar
```
cat bug_report.log | gemini "Genera un fix para este error" --headless > patch.diff
```
Elimina la interfaz interactiva para usar la CLI como un binario de procesamiento puro dentro de scripts de Bash, pipelines de Jenkins o GitHub Actions.

Conceptos Clave

Comprender estos conceptos fundamentales te ayudará a dominar Gemini CLI de forma más organizada y eficiente:

Agentes con Tool-Use:

A diferencia de un chat convencional, Gemini CLI utiliza herramientas (Tools) de forma autónoma. Puede decidir leer un archivo, buscar en internet o ejecutar un script basándose únicamente en la meta del usuario.
Jerarquía de Contexto:

El sistema prioriza información en tres niveles: Memoria Global (hechos del usuario), Contexto de Proyecto (GEMINI.md) y Contexto de Sesión (el chat actual). Esto garantiza precisión técnica quirúrgica.
Token Caching Adaptativo:

Optimización de costos en 2026 que detecta bloques de código repetidos en las consultas y los almacena en caché en los servidores de Google, reduciendo drásticamente la latencia en proyectos de millones de líneas.
Skills y Extensiones:

Capacidad de cargar módulos especializados ('Skills') que dotan al agente de conocimientos profundos en áreas como Ciberseguridad, MLOps o Optimización de Consultas SQL.

Casos de uso

Algunos ejemplos de aplicaciones prácticas donde se utiliza Gemini CLI:

Refactorización Multimodular Automática:

Migración de bases de código completas. Ej: 'Convierte todos los servicios de Express a Fastify, actualiza las rutas y genera la nueva documentación de Swagger'.
SRE e Investigación de Incidentes:

Uso de la CLI para analizar logs en tiempo real: 'Escucha el stdout de este contenedor y avísame si detectas patrones de saturación de memoria, sugiriendo cambios en el config de K8s'.
Generación de Código Dirigida por Pruebas (TDD):

El agente escribe el test basándose en el GEMINI.md, intenta ejecutarlo, falla, escribe el código para que pase, y repite el ciclo hasta que el comando de test sea exitoso.

Consejos para Principiantes

Aquí tienes algunas recomendaciones para facilitar tus inicios en Gemini CLI:

Empieza con el Modo Plan (Plan Mode):

Usa `/settings plan-mode on` para que el agente primero describa qué va a hacer antes de realizar cambios en tus archivos, evitando errores accidentales.
Configura .geminiignore desde el día uno:

Evita que el agente lea carpetas como `node_modules` o archivos `.env`. Esto ahorra tokens y protege tus claves secretas de ser enviadas al modelo.
Usa /stats para controlar tu presupuesto:

Este comando te da un desglose detallado de los tokens usados por sesión, archivos subidos al File API y el costo estimado en tiempo real.

Gemini CLI por Santiago Soñora

“Hola, mundo” en Gemini CLI

Comandos básicos

Conceptos Clave

Casos de uso

Consejos para Principiantes

Herramientas relacionadas

Recursos útiles