Tu agente de código está construyendo una landing y necesita analizar un brief, generar tres opciones de texto y guardar una imagen de prueba. Puede escribir integración con un SDK para cada paso, pero eso añade dependencias a un proyecto que quizá solo necesita un experimento. Google lanzó el 27 de octubre de 2026 Gemini API CLI en beta, un cliente de línea de comandos para llamar Gemini desde scripts, CI y agentes que ya tienen acceso a una terminal. La decisión útil es saber cuándo conviene y cuándo no.

Es una API en la terminal, no otro agente de programación

La guía oficial llama al ejecutable gemini-api. Es un cliente sin estado oculto: cada comando hace una llamada a Interactions API y devuelve texto, metadatos o una ruta de archivo. Puede generar texto y medios, analizar archivos y lanzar agentes gestionados de Gemini. Google advierte que no es el asistente interactivo @google/gemini-cli, aunque ambos se usen desde una terminal. Tampoco reemplaza los SDK de GenAI cuando estás incorporando capacidades de Gemini dentro del backend de una aplicación.

Para un vibecoder, la ventaja es que Claude Code, Codex, Cursor u otro agente con shell pueden invocar un comando sin pegar imágenes en base64 dentro del chat ni añadir un paquete al código del producto. Para un equipo de producto, la desventaja es igual de clara: el comando todavía necesita una clave API, límites, control de costos y una política sobre los archivos que se envían.

Una prueba sin tocar tu aplicación

Instala una versión concreta desde los releases oficiales, siguiendo la guía para tu sistema. La herramienta es beta y Google advierte que puede introducir cambios incompatibles entre versiones menores; fija la versión en CI. Guarda la clave GEMINI_API_KEY en el gestor de secretos del entorno, nunca en el repositorio ni en una captura de tutorial.

Con la CLI ya instalada, abre una terminal en una carpeta de pruebas y ejecuta:

gemini-api --help
gemini-api generate "Propón tres titulares claros para una app de notas." --dry-run -o json

--dry-run valida la solicitud y muestra una vista previa sin hacer la llamada de generación. Comprueba el modelo elegido, el texto y cualquier archivo adjunto antes de pagar por una ejecución. Si la vista previa es correcta y tienes una clave configurada, quita --dry-run:

gemini-api generate "Propón tres titulares claros para una app de notas." --stream=false -o json

El resultado debe ser un objeto JSON con la respuesta de la API, no un cambio automático en tu proyecto. Para analizar un archivo no sensible, la documentación ofrece gemini-api analyze -i ./brief.pdf "Resume los requisitos". Revisa siempre las conclusiones contra el documento. Estos comandos están basados en la guía oficial; no hice una llamada pagada ni probé el binario en una cuenta de Joseph.

Qué herramienta elegir

• gemini-api: un agente o script necesita una llamada puntual a Gemini, un archivo de salida o un paso de CI.
• SDK de Google GenAI: la función va dentro de una app, necesita manejo de errores, pruebas, autenticación y flujo de datos integrado.
• Gemini CLI interactivo: quieres conversar con un agente de programación en tu terminal; es otro producto y otra experiencia.

La CLI ofrece además --schema para inspeccionar opciones, --agent-mode para errores estructurados y códigos de salida diferenciados: 0 éxito, 2 uso inválido y 3 autenticación. Esas señales ayudan a que una automatización falle de forma visible en lugar de inventar que completó la tarea.

Límites antes de automatizar

La beta usa Interactions API, por lo que revisa el valor de almacenamiento de solicitudes si procesas datos de terceros. Los archivos pequeños enviados con -i tienen un límite documentado de 14 MB de datos crudos; para mayores, usa Files API y ten en cuenta su ciclo de vida. La CLI no soporta WebSockets bidireccionales: para voz o video en tiempo real, Google remite a los SDK y Live API. Si vas a usarla para generar medios en un flujo de publicación, trata cada costo y licencia de salida como parte del diseño, no como un detalle del comando.

Mi prueba recomendada para esta semana es pequeña: una carpeta desechable, un brief sintético y un solo --dry-run. Si el comando y su salida encajan con tu proceso, integra un paso real con versión fijada y costo medido. Si necesitas mantener estado, validar usuarios o ejecutar lógica de producto, empieza por el SDK.