Image for post Gemini CLI v0.36: Subagentes Locales y GitHub Actions

Gemini CLI v0.36: Subagentes Locales y GitHub Actions

Escrito por Sergio Márquez

TL;DR: Gemini CLI v0.36 introduce ejecución local de subagentes con aislamiento de herramientas, sandbox nativo en Windows y macOS, y un memory manager experimental. Combinado con la integración gratuita de GitHub Actions, Google posiciona su agente de terminal como plataforma multi-agente completa.

Qué cambia en Gemini CLI v0.36

Google publicó entre el 24 y el 28 de marzo de 2026 seis preview releases de Gemini CLI v0.36, desde preview.0 hasta preview.6. La versión estable sigue en v0.35.2, pero el volumen de cambios anticipa la actualización más significativa desde que Gemini CLI se consolidó como agente de terminal.

Tres bloques definen esta versión: subagentes con ejecución local, sandbox multiplataforma y memory manager experimental. El ecosistema se completa con la integración oficial de GitHub Actions, que extiende estos agentes al CI/CD.

Subagentes locales: ejecución aislada y filtrado dinámico

La funcionalidad estrella de v0.36 es la ejecución local de subagentes. Hasta v0.35, los subagentes ya existían (se activaron por defecto en v0.35.2), pero v0.36 añade ejecución local con aislamiento completo: cada subagente opera en su propio bucle de contexto con un conjunto restringido de herramientas.

La configuración de herramientas usa wildcards para control granular:

{
  "subagents": {
    "investigator": {
      "tools": ["read_file", "list_directory", "web_fetch"],
      "description": "Analiza código sin modificar archivos"
    },
    "refactorer": {
      "tools": ["read_file", "edit_file", "mcp_*"],
      "description": "Refactoriza con acceso a todos los MCP servers"
    }
  }
}

Esto resuelve un problema concreto: cuando pides al agente principal una tarea compleja, su contexto se llena de resultados intermedios que degradan la calidad de respuestas posteriores. Los subagentes procesan la tarea en contexto limpio y devuelven solo el resumen final al agente principal.

El sistema incluye tres mejoras clave:

  • Multi-registry discovery: encuentra subagentes desde fuentes locales, remotas y extensiones de forma unificada.
  • JIT context injection: inyecta contexto del proyecto al subagente solo cuando lo necesita, sin cargar todo desde el inicio.
  • Filtrado dinámico de herramientas: ajusta los permisos del subagente en tiempo de ejecución según la tarea.

Si trabajas con arquitecturas multi-agente locales, el patrón es familiar: aislar contexto por tarea es lo que mejor escala cuando el agente necesita mantener coherencia en sesiones largas.

Sandbox nativo en los tres sistemas operativos

v0.36 completa el soporte de sandboxing con mecanismos nativos para cada plataforma:

SistemaMecanismoEstado en v0.36
Linuxbubblewrap + seccompEstable (desde v0.35)
macOSSeatbelt allowlist estrictoNuevo
WindowsSandbox nativo de WindowsNuevo

Los governance files protegidos contra escritura complementan el sandbox: puedes marcar archivos como GEMINI.md o configuraciones de seguridad como inmutables para el agente. Esto evita que un subagente modifique las reglas que lo gobiernan, un detalle importante cuando delegas tareas con herramientas de escritura.

GitHub Actions: Gemini CLI en tu pipeline CI/CD

La acción oficial google-github-actions/run-gemini-cli lleva disponible desde mediados de 2025, pero gana relevancia ahora con la madurez que v0.36 aporta a los subagentes. A diferencia de Copilot Agent Mode, que opera dentro del IDE, Gemini CLI GitHub Actions funciona de forma asíncrona directamente en tu repositorio.

Los workflows preconfigurados cubren tres escenarios:

  • Categorización automática de issues: etiqueta, prioriza y clasifica issues nuevos sin intervención manual.
  • Revisión de PRs con IA: analiza estilo, bugs potenciales y correctitud antes de la revisión humana.
  • Comandos on-demand: menciona @gemini-cli en un comentario con /review, /triage o /write-tests para activar tareas específicas.

Un dato relevante para el debate sobre costes en herramientas IA: Gemini CLI GitHub Actions es gratuito. Google absorbe el coste del modelo, con un tier que incluye Gemini 3, 1M tokens de contexto, 60 requests/minuto y 1.000 requests/día.

Más novedades de v0.36 que merecen atención

  • Memory manager experimental: un agente interno reemplaza la herramienta save_memory y gestiona la persistencia del contexto de forma autónoma entre sesiones.
  • Git worktree support: sesiones paralelas aisladas usando worktrees de git, cada una con su propio estado de agente y tracking de telemetría independiente.
  • ModelChain y resolución dinámica: el ModelConfigService soporta cadenas de modelos con resolución en tiempo de ejecución, útil para configurar fallback entre modelos.
  • ACP SDK 0.16.1: el protocolo de comunicación entre agentes se actualiza con metadata de uso de tokens en las respuestas, clave para controlar costes.
  • Task tracker en system prompt: el seguimiento de tareas se integra directamente en el prompt del sistema, con estados "blocked" para tareas y todos.

Cómo instalar o actualizar Gemini CLI

Para probar las novedades de v0.36 en preview:

# Instala la preview con subagentes locales y sandbox multiplataforma
npm install -g @google/gemini-cli@preview
gemini --version

Para la versión estable (v0.35.2, que ya incluye subagentes activados por defecto):

npm install -g @google/gemini-cli
gemini --version

Si ya tenías Gemini CLI instalado, el mismo comando actualiza a la última versión del canal elegido.

En Producción

No uses v0.36.0-preview en entornos de producción ni en scripts que dependan de la estabilidad de la API de subagentes. El memory manager está marcado como experimental y su interfaz puede cambiar antes de la release estable.

Para desarrollo individual y pruebas, el riesgo es bajo. El sandbox impide modificaciones sin tu confirmación, y puedes volver a estable con npm install -g @google/gemini-cli@latest en cualquier momento.

GitHub Actions sí está listo para producción. El coste es cero en el tier gratuito, pero los límites pueden ser restrictivos: 1.000 requests/día se consumen con rapidez en repositorios activos. Un monorepo con 50 PRs diarias agotará su cuota si no filtras por labels o paths en el workflow.

Para equipos, la autenticación con Workload Identity Federation elimina la gestión manual de API keys. Es la opción correcta si ya estás en Google Cloud.

Errores comunes en la actualización

Error: npm ERR! EACCES permission denied al instalar globalmente.
Causa: npm sin permisos de escritura en el directorio global.
Solución: configura npm para usar un directorio local con npm config set prefix ~/.npm-global y añádelo al PATH.

Error: subagentes no disponibles tras actualizar a preview.
Causa: settings.json heredado de una versión anterior con subagentes desactivados.
Solución: ejecuta gemini /settings y verifica que subagents.enabled está en true.

¿Cuándo llegará v0.36 a la versión estable?

Google publica releases estables semanalmente. Con la preview.6 publicada el 28 de marzo de 2026, la versión estable debería llegar entre el 31 de marzo y el 2 de abril si no se detectan regresiones en los builds nocturnos.

¿Puedo usar subagentes con modelos locales via Ollama?

Gemini CLI soporta URLs base personalizadas via variables de entorno, lo que permite apuntar a endpoints compatibles. Sin embargo, los subagentes dependen de funcionalidades específicas de Gemini 3 (function calling, contexto largo) que los modelos locales no replican con la fiabilidad necesaria a día de hoy.

¿Gemini CLI GitHub Actions compite con Copilot en revisión de PRs?

Directamente. Copilot ofrece revisión integrada en GitHub pero requiere licencia (desde 10 €/mes). Gemini CLI GitHub Actions es gratuito y más configurable en workflows, aunque la integración nativa de Copilot resulta más fluida si ya pagas GitHub Enterprise.

Gemini CLI v0.36 no es una iteración menor. Los subagentes con ejecución local aislada convierten una herramienta de terminal en plataforma de orquestación, el sandbox multiplataforma cierra el gap de seguridad en macOS y Windows, y GitHub Actions extiende todo esto al CI/CD del equipo. Para quienes seguimos la evolución de los agentes de código, como exploramos en la reflexión sobre AI fatigue, el patrón se confirma: las herramientas que sobreviven son las que pasan de asistente individual a infraestructura de equipo.

¿Ya usas Gemini CLI en tu flujo diario? Cuéntame qué subagentes configurarías primero en Twitter @sergiomarquezp_.

Volver al blog