Agentes Soportados (Multi-Driver)

gz-ia implementa el patrón de diseño Driver para desacoplar completamente la lógica del arnés respecto a los comandos y particularidades de cada motor agéntico.

El arnés detecta dinámicamente qué agentes están instalados en tu sistema (exec.LookPath) y traduce las banderas de permisos y argumentos a la sintaxis nativa de cada herramienta.

---

Matriz de Compatibilidad de Motores

Proveedor (ID)	Binario	Nombre para Mostrar	Flag Autónomo	Flag Resume	Inyección Prompt	Modo Readonly
agy	agy	Google Antigravity	--dangerously-skip-permissions	--continue	-i <prompt>	--mode plan
claude	claude	Anthropic Claude Code	--dangerously-skip-permissions	--resume	-p <prompt>	Consulta segura
opencode	opencode	OpenCode	--dangerously-skip-permissions	--continue	<prompt>	Consulta segura
pi-agent	pi-agent	Pi Agent	--dangerously-skip-permissions	--resume	-p <prompt>	Consulta segura

---

Detalle e Instalación por Agente

Google Antigravity (agy)

El agente de codificación de terminal de Google DeepMind / Google Antigravity.

• Identificador: agy
• Binario requerido: agy
• Comportamiento en readonly: Inyecta automáticamente el parámetro --mode plan, permitiendo al agente analizar y proponer planes detallados de arquitectura sin alterar el código ni ejecutar comandos destructivos.
• Comportamiento en autonomous: Agrega --dangerously-skip-permissions para ejecución continua dentro del worktree.
• Reanudación: Emplea --continue al ejecutar gz-ia session resume <id>.

Instalación

Sigue las instrucciones oficiales de instalación de la CLI de Antigravity en tu entorno de desarrollo.

---

Anthropic Claude Code (claude)

La herramienta oficial de línea de comandos de Anthropic para desarrollo asistido por Claude 3.7 Sonnet y modelos de la familia Claude.

• Identificador: claude
• Binario requerido: claude
• Comportamiento en autonomous: Agrega el flag --dangerously-skip-permissions.
• Reanudación: Emplea --resume en la sesión anterior.

Instalación Rápida

Puedes instalar Claude Code globalmente mediante npm:

npm install -g @anthropic-ai/claude-code

---

OpenCode (opencode)

El agente de terminal de código abierto orientado a desarrollo autónomo.

• Identificador: opencode
• Binario requerido: opencode
• Comportamiento en autonomous: Inyecta --dangerously-skip-permissions.
• Reanudación: Emplea --continue.

Instalación Rápida

Instalación mediante el script oficial:

curl -fsSL https://opencode.ai/install | bash

---

Pi Agent (pi-agent)

Agente ligero de terminal diseñado para automatización rápida de tareas de desarrollo.

• Identificador: pi-agent
• Binario requerido: pi-agent
• Comportamiento en autonomous: Agrega --dangerously-skip-permissions.
• Reanudación: Emplea --resume.

Instalación

Consulta la documentación oficial de distribución de Pi Agent CLI para tu sistema operativo.

---

Niveles de Permiso en Detalle

gz-ia normaliza el control de privilegios en 3 niveles conceptuales estrictos:

1. readonly (Solo Lectura / Planificación):

   • Ideal para auditorías de código, análisis de seguridad y generación de planes.
   • En agy, activa explícitamente el modo --mode plan.
   • Garantiza que el agente no ejecute herramientas que muten el sistema de archivos.

2. supervised (Supervisado — Valor por Defecto):

   • El agente ejecuta en modo interactivo estándar.
   • Cada comando de terminal y cada modificación de archivo solicita confirmación humana explícita antes de proceder.
   • Recomendado para programación en parejas (pair-programming).

3. autonomous (Autónomo en Espacio de Trabajo Aislado):

   • Pasa los flags de auto-aprobación del agente (--dangerously-skip-permissions).
   • El agente puede editar, crear archivos y ejecutar comandos sin interrupción.
   • Garantía de Seguridad: Al combinarse con Git Worktrees, todo impacto queda recluido en .harness/worktrees/<id>, impidiendo daños en tu rama activa de Git.

---

Cómo Seleccionar el Agente

Desde la Línea de Comandos (CLI)

Utiliza la bandera -p o --provider:

# Iniciar chat con Claude Code
gz-ia chat --provider claude

# Iniciar chat con OpenCode en modo autónomo
gz-ia chat -p opencode -m autonomous

# Si no se especifica, gz-ia selecciona automáticamente el primer agente disponible
gz-ia chat

Desde la TUI Interactiva

Al iniciar gz-ia start y seleccionar "Iniciar nuevo chat con agente", el selector inteligente mostrará el estado de cada driver:

? ¿Qué agente de terminal deseas utilizar?
  > [✓] Google Antigravity (agy)
    [✓] Claude Code (claude)
    [✗] OpenCode (opencode) - No instalado
    [✗] Pi Agent (pi-agent) - No instalado
    [←] Volver al menú principal