Gemini CLI

Qué es Gemini CLI

Agente open source de Google en la terminal. Modelos Gemini por defecto; extensible con skills y MCP. Alternativa en CLI al ecosistema Google que en IDE incluye Antigravity.

Repo: google-gemini/gemini-cli
Docs: geminicli.com

Orden sugerido

1. Instalación y auth

Sigue el README oficial (npm, brew, etc.). Necesitas API key de Google AI Studio o cuenta según el modo que elijas. Configura límites y no commitees keys.

2. Contexto del repo

AGENTS.md en repos compartidos: build, tests, convenciones. En sesiones sueltas, describe stack y comandos en el primer prompt — pero en equipo, un solo archivo en la raíz evita drift.

3. Skills

Documentación: geminicli.com/docs/cli/skills/. Mismo formato SKILL.md que Agent Skills. Guía: ¿Qué es un skill?.

Añade skills solo para tareas repetidas (review, migración, checklist). Ejemplo del catálogo: ui-skills para frontend — no es obligatorio al inicio.

4. MCP

Configura servidores MCP desde la doc oficial cuando el agente necesite datos externos. Guía: ¿Qué es un MCP?. Un MCP bien elegido (ej. Context7) suele bastar.

Para browser/E2E: Playwright MCP o Chrome DevTools MCP — uno, no los dos el primer día.

5. Modelos y APIs

Por defecto Gemini en nube vía API key. Para capas gratuitas o créditos de prueba: Free LLM API Resources (verifica términos).

Modelos locales: según versión, Gemini CLI puede apuntar a endpoints compatibles; el camino habitual en Google sigue siendo API Gemini. Stack local completo (Ollama, Qwen): Modelos nube vs locales y agentes como OpenCode o Cline.

Dónde va cada cosa

Pieza	Ubicación habitual
Contexto repo	AGENTS.md
Skills	Según doc Gemini CLI (carpeta de skills del proyecto o global)
MCP	Config en settings / json (ver doc oficial)
Auth	Variable de entorno / config local (no en git)

Gemini CLI vs Antigravity vs Claude Code

	Gemini CLI	Antigravity	Claude Code
Interfaz	Terminal	IDE + Agent Manager	Terminal / IDE / desktop
Modelos	Gemini (API)	Gemini, Claude, OpenAI	Claude
Open source	Sí (CLI)	No (preview Google)	No
Multi-agente	Una sesión CLI	Agent Manager nativo	Sesiones + subagentes (según plan)
Skills / MCP	Sí	Sí	Sí

Cuándo elegir Gemini CLI

• Prefieres terminal + modelos Google sin cambiar de IDE.
• Quieres agente open source alternativo a Claude Code / Codex.
• Ya usas Google AI Studio y quieres el mismo ecosistema en CLI.

Cuándo mirar Antigravity en su lugar

• Quieres editor visual, Agent Manager y varios agentes en paralelo con UI Google.
• No te importa preview cerrada frente a CLI open source.

Recursos del catálogo

• Skill polémico de menos código: ponytail — léelo antes; no es requisito.
• Comprimir contexto en sesiones largas: Headroom (wrap/proxy; avanzado).

Errores comunes

• API key sin límites en repos públicos o CI.
• Asumir paridad 1:1 con Claude Code en hooks o plugins de terceros.
• Activar muchos MCPs antes de dominar AGENTS.md + un skill útil.