Gemini CLI: Guía completa para instalar, usar extensiones y automatizar con IA desde la línea de comandos

  • Autor de la entrada:
  • Última modificación de la entrada:10 octubre, 2025

Cover Image

Gemini CLI: guía completa para instalar, usar extensiones y automatizar con IA desde la línea de comandos

Lectura estimada: 10–15 minutos

Key takeaways

  • Gemini CLI permite integrar modelos avanzados desde la terminal y crear flujos automatizados.
  • Gemini 2.5 Pro ofrece sesiones persistentes, prioridad de cómputo y contexto extendido (ideal para equipo).
  • El marketplace de extensiones facilita integraciones con Git, Slack, JIRA, OCR y más.
  • Buenas prácticas: proteger GEMINI_API_KEY, auditar permisos de extensiones y usar entornos aislados.

Tabla de contenidos

Novedades en Gemini 2.5 Pro

Gemini 2.5 Pro trae mejoras pensadas para uso profesional y automatización desde la terminal. Aquí lo esencial:

  • Modelo y calidad
    • Mejor coherencia en conversaciones largas y respuestas más relevantes en contextos técnicos.
    • Más capacidad multimodal (texto + imágenes) en tareas de documentación y debugging.
  • Velocidad y latencia
    • Prioridad de cómputo para usuarios Pro: respuestas hasta ~30% más rápidas en cargas altas (demo).
    • Sesiones persistentes con contexto extendido para pipelines largos.
  • Gestión de sesiones y estado
    • Soporte nativo para “sessions”: puedes mantener contexto entre comandos sin repropagar datos.
    • Mejora para manejar históricos de PRs, tickets y logs.
  • Seguridad y control
    • Controles avanzados de acceso y auditoría de extensiones.
    • Cifrado en tránsito y gestión de claves para entornos empresariales.

Diferencias entre Gemini CLI gratis y Gemini 2.5 Pro

  • Gemini CLI gratis
    • Acceso al modelo base con límites de contexto y QPS.
    • Ideal para pruebas, scripts personales y aprendizaje.
  • Gemini 2.5 Pro
    • Prioridad computacional, contexto extendido, sesiones persistentes y SLAs mejores.
    • Coste por uso, pero notable ahorro de tiempo en flujos de trabajo automatizados.

Ejemplos concretos de la demo (transcripción)

Comando en demo para resumir un PR usando 2.5 Pro:

gemini chat --model=gemini-2.5-pro --session=ci "Resume este PR en 5 puntos y sugiere labels"

Salida: resumen estructurado + sugerencia de labels y prioridad (demo timestamp 00:20:10).

“La sesión mantuvo el contexto de 3 commits sin pedirlos de nuevo” — Presentador (Transcripción, 00:05:12)

Estas mejoras hacen que Gemini 2.5 Pro sea especialmente útil para equipos que quieren automatizar tareas repetitivas desde la terminal con menos fricción y mayor seguridad.

¿Qué son las extensiones y el marketplace de extensiones de IA?

Las extensiones en Gemini CLI son módulos que añaden capacidades prácticas al CLI: conectores a servicios, transformadores de datos y comandos especializados.

Por qué importan

  • Extienden Gemini CLI sin tocar tu código base.
  • Permiten integraciones con herramientas comunes: Git, Slack, JIRA, OCR, scraping.
  • Proveen seguridad y control granular sobre permisos que cada extensión solicita.

El marketplace de extensiones de IA

  • Es un catálogo central donde descubrir, revisar y evaluar extensiones.
  • Incluye metadata: permisos requeridos, autor, reviews y ejemplos de uso.
  • Permite instalar extensiones locales (para desarrollo) o remotas (publicadas).

Comandos típicos para interactuar con el marketplace (ejemplo)

  • Listar extensiones disponibles: 
    gemini extensions list
  • Ver detalles de una extensión: 
    gemini extensions info git-integration
  • URL del marketplace (para explorar visualmente).

Extensiones populares (ejemplos prácticos)

  • Integración con Git: generar resúmenes de PRs, crear mensajes de commit inteligentes.
  • Slack: enviar notificaciones con resúmenes automáticos.
  • Scraper/HTML: extraer contenido web y convertirlo en prompts limpios.
  • OCR: leer imágenes de documentos y generar tickets o resúmenes.

Consejo rápido: al elegir una extensión, revisa permisos exactos, reputación del autor y dependencias externas.

Cómo instalar Gemini CLI (sección práctica paso a paso)

Antes de instalar

  • Sistemas soportados: macOS, Linux (Debian/Ubuntu, Fedora, Arch), Windows 10/11.
  • Requisitos comunes: curl o wget, shell estándar (bash/zsh/powershell), cuenta con API key de Gemini.

Configurar la API key (recomendado)

Genera tu clave desde la consola de desarrollador y guárdala en una variable de entorno:

# macOS / Linux:
export GEMINI_API_KEY="tu_api_key_aqui"

# Windows PowerShell:
$env:GEMINI_API_KEY="tu_api_key_aqui"

Instalación por sistema operativo

macOS (Homebrew)

brew install gemini-cli
gemini --version  # salida esperada: gemini-cli 2.5.0

macOS / Linux (instalador vía curl)

curl -fsSL https://get.gemini.ai | bash
gemini --version

Debian/Ubuntu (APT)

sudo apt update
sudo apt install gemini-cli
gemini --version

Fedora / Arch

# Fedora:
sudo dnf install gemini-cli

# Arch (AUR o repo):
pacman -S gemini-cli

Windows (winget)

winget install Google.GeminiCLI
# o usa el instalador MSI desde la página oficial
gemini --version

Problemas comunes y soluciones rápidas

  • gemini: command not found — añade el binario al PATH o reinicia la terminal.
  • Error de autenticación (401) — revisa GEMINI_API_KEY y que no tenga espacios.
  • Instalación fallida por permisos — usa sudo o instala en modo usuario (~/.local/bin).

Advertencia de seguridad

No pegues tu API key en repositorios ni en scripts públicos. Usa vaults o secretos en CI (GitHub Secrets, GitLab CI variables).

Referencia de documentación y marketplace: Documentación oficial e instalación — y el marketplace de extensiones.

Cómo instalar y gestionar extensiones

Buscar extensiones en el marketplace

  • Desde la terminal: 
    gemini extensions list
gemini extensions search git
  • Desde el navegador, explora el catálogo.

Instalar una extensión (remota vs local)

  • Instalar desde el marketplace (remoto): 
    gemini extensions install git-integration
  • Instalar en desarrollo (local): 
    gemini extensions install --local ./mi-extension
  • Verificar extensiones instaladas: 
    gemini extensions list --installed

Actualizar y desinstalar

  • Actualizar todas las extensiones: 
    gemini extensions update --all
  • Actualizar una extensión específica: 
    gemini extensions update git-integration
  • Desinstalar: 
    gemini extensions uninstall git-integration

Gestión de dependencias y sandboxing

  • Las extensiones pueden declarar dependencias externas (Python, Node). Revisa los requisitos antes de instalar.
  • Prefiere entornos virtuales (venv, nvm) para evitar conflictos.
  • Usa –local para depurar durante el desarrollo.

Auditoría de permisos y seguridad

Antes de instalar, ejecuta gemini extensions info git-integration y revisa permisos solicitados (lectura de repos, acceso a red). Si una extensión solicita acceso amplio, considera instalarla en un entorno aislado.

Comandos personalizados Gemini y ejemplos prácticos

Estructura básica de un comando personalizado

Un comando personalizado puede ser un wrapper que llama a gemini chat o a una extensión. Ejemplo mínimo (bash):

#!/usr/bin/env bash
PR_BRANCH=$1
git fetch origin $PR_BRANCH
git checkout $PR_BRANCH
gemini chat --model=gemini-2.5-pro --session=pr-summarizer "Resume los cambios de $PR_BRANCH en 5 puntos"

Guarda como binario ejecutable en tu PATH para usarlo como comando.

Ejemplo 1 — Resumen automático de PRs

Pipeline: Trigger: PR abierto — Acción: GitHub Action que ejecuta un job y llama a gemini chat.

runs-on: ubuntu-latest
steps:
  - uses: actions/checkout@v3
  - name: Resumir PR con Gemini
    run: gemini chat --model=gemini-2.5-pro --session=ci "Resume este PR en 5 puntos y sugiere labels"

Comando demo en la presentación: gemini chat –model=gemini-2.5-pro –session=ci “Resume este PR…” (demo)

Ejemplo 2 — Generar issues desde README

cat README.md | gemini chat --model=gemini-2.5-pro "Extrae 5 tareas accionables y formatea como issues"

Ejemplo 3 — Búsqueda semántica local

gemini embeddings create --input docs/ --output index.db
gemini search --index index.db --query "Cómo configurar la CI para despliegues canary"

Automatización con Gemini CLI: flujos reales

Automatización con scripts y cron

Ejemplo: reporte diario de errores desde logs

0 7 * * * /usr/local/bin/gemini-report-errors.sh

#!/usr/bin/env bash
tail -n 1000 /var/log/app.log | gemini chat --model=gemini-2.5-pro "Resume los 10 errores más frecuentes y sugiere prioridades"

Integración en CI/CD (GitHub Actions)

uses: actions/checkout@v3
run: |
  gemini chat --model=gemini-2.5-pro --session=ci "Analiza los últimos commits y genera la descripción del PR" > pr_description.md
  gh pr edit ${{ github.event.pull_request.number }} --body-file pr_description.md

Casos por rol

  • DevOps: triage y despliegues canary.
  • Product Manager: resúmenes de feedback y priorización.
  • Soporte: respuestas iniciales automatizadas con templates.

Plantilla YAML reproducible (mini-Action)

name: auto-pr-summary
on: pull_request
jobs:
  summarize:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v3
      - name: Generar resumen
        run: gemini chat --model=gemini-2.5-pro --session=ci "Resume este PR en 5 puntos y sugiere labels" > summary.md
      - name: Publicar comentario
        uses: actions/github-script@v6
        with:
          script: |
            const fs = require('fs');
            const body = fs.readFileSync('summary.md','utf8');
            github.rest.issues.createComment({owner, repo, issue_number: context.payload.pull_request.number, body});

Integraciones con herramientas populares

Integraciones nativas y vía extensiones

  • VS Code: usar Gemini CLI desde el terminal integrado; extensiones para snippets y completions.
  • Git: integración para generar mensajes de commit y summaries.
  • Slack y JIRA: extensiones que publican mensajes y crean tickets automáticos.

Configurar integraciones seguras

  • Nunca pongas tokens en código.
  • Usa secrets (GitHub Secrets, GitLab CI variables).
  • Limita scopes: por ejemplo, token GitHub con acceso solo a repos específicos.

Ejemplo — VS Code + Gemini CLI

Instala la extensión de VS Code para Gemini (si existe) o usa el terminal integrado y ejecuta comandos gemini para outputs rápidos.

Seguridad, privacidad y buenas prácticas

Gestión de claves y secretos

Usa variables de entorno y vaults (HashiCorp Vault, AWS Secrets Manager). Evita hardcodear GEMINI_API_KEY en scripts: usa secret injection en CI.

Control de acceso para extensiones

Revisa scopes y permisos antes de instalar. Opera extensiones con el principio de menor privilegio.

Auditoría de outputs

Redacta datos sensibles antes de enviarlos a modelos. Implementa logging y revisiones periódicas de prompts y resultados.

Limitaciones

Gemini CLI gratis tiene límites de contexto y QPS; para cargas productivas considera Gemini 2.5 Pro.

Comparativa rápida: Gemini CLI vs otras herramientas de IA en terminal

Diferenciadores clave

  • Modelo: acceso directo a modelos Gemini (incluyendo 2.5 Pro) con contexto extendido.
  • Marketplace: catálogo oficial de extensiones que facilitan integraciones.
  • UX: comandos simples y sesiones persistentes.

Pros / Cons

  • Pros: fácil integración con pipelines, extensiones listas para usar, soporte multimodal en 2.5 Pro.
  • Cons: coste para uso Pro, algunas extensiones en crecimiento o con dependencias externas.

Problemas comunes y cómo solucionarlos

Errores de instalación

  • gemini: command not found — añade el binario al PATH o reinicia la terminal.
  • Permisos en instalación — instala en modo usuario (~/.local/bin) o usa sudo.

Errores de autenticación (401)

Revisa GEMINI_API_KEY y que no tenga espacios. En CI, confirma que el secret esté disponible en el job.

Incompatibilidades de extensiones

Ejecuta en entorno aislado y revisa logs:

gemini extensions logs git-integration

Prueba con --local para depurar.

Comandos para debug y logs

  • gemini –debug <comando>
  • gemini extensions logs <extension>
  • Revisa rutas de configuración en ~/.config/gemini/

Enlaces útiles: Docs oficiales — Marketplace

Casos de estudio: mini-ejemplos reales

Caso A — Equipo de soporte

  • Problema: alto volumen de tickets repetitivos.
  • Solución: script nightly que resume tickets y sugiere respuestas.
  • Resultado: tiempo medio de primera respuesta reducido ~30% (estimación en demo) — demo.

Caso B — Equipo de ingeniería (PR workflow)

  • Problema: descripciones de PR inconsistentes.
  • Solución: GitHub Action que usa gemini chat para generar la descripción del PR y labels.
  • Resultado: menos ida y vuelta en reviews y mayor velocidad de merge.

Comandos exactos usados en demo:

gemini chat --model=gemini-2.5-pro --session=ci "Resume este PR en 5 puntos y sugiere labels"

“La sesión mantuvo el contexto de 3 commits sin pedirlos de nuevo” — Presentador (Transcripción)

Conclusión y próximos pasos

Gemini CLI acelera workflows cotidianos al permitirte automatizar tareas y orquestar integraciones desde la terminal. Prueba primero la versión gratuita para scripts personales y después escala a Gemini 2.5 Pro si necesitas sesiones persistentes y mayor throughput.

Prueba sugerida:

  • Instala Gemini CLI (o actualiza) y ejecuta: gemini --version
  • Instala una extensión de Git y prueba el comando de resumen de PR.

CTA: Prueba Gemini CLI gratis — Explora el marketplace de extensiones de IA.

FAQ (Preguntas frecuentes detalladas)

Q: ¿Necesito pagar para usar Gemini CLI?

R: Puedes usar la versión gratuita con límites. Gemini 2.5 Pro ofrece priorización, contexto extendido y SLAs para uso productivo.

Q: ¿Cómo protejo mi GEMINI_API_KEY en CI?

R: Usa secrets del proveedor CI (GitHub Secrets, GitLab CI variables) y evita exponer logs que contengan la clave. Usa roles y scopes con menor privilegio.

Q: ¿Puedo desarrollar mi propia extensión?

R: Sí. Usa el SDK/CLI para crear extensiones locales y prueba con --local antes de publicarla. Revisa el manifest para declarar permisos y dependencias.

Q: ¿Qué hago si una extensión solicita permisos excesivos?

R: No la instales en entornos sensibles. Abre un issue con el autor y solicita un manifiesto con menor scope o usa un entorno aislado.

Q: ¿Cómo depuro un comando que falla en CI?

R: Ejecuta gemini --debug, revisa logs de la extensión y añade pasos de logging temporales en tu workflow. Reproduce localmente con las mismas variables de entorno.

Q: ¿Dónde reporto bugs o sugiero mejoras?

R: Usa el repositorio o la página de la extensión en el marketplace. Para issues del CLI, revisa la documentación oficial y el repo enlazado allí.

Recuerda: empieza con tareas pequeñas y medibles (resúmenes de PR, triage de tickets), automatiza con cuidado y aplica buenas prácticas de seguridad. Gemini CLI facilita usar inteligencia artificial línea de comandos; aprovéchalo para optimizar tu flujo de trabajo.