Referencia de comandos · Antigravity CLI
agy agent / agy agents
Lista los agentes personalizados disponibles.
agy agent o agy agents es un subcomando de Antigravity CLI (desde la versión 1.1.1) que lista en la línea de comandos todos los agentes personalizados disponibles antes de iniciar una sesión. Los agentes personalizados se definen como un archivo Markdown agent.md con frontmatter YAML, ya sea a nivel de proyecto en .agents/agents/<name>/agent.md o globalmente en ~/.gemini/config/agents/<name>/agent.md. El nombre encontrado con agy agents se puede pasar directamente a la opción de inicio --agent para arrancar la CLI de inmediato con ese agente, por ejemplo agy --agent code-reviewer. Dentro de una sesión ya en marcha, en cambio, el panel interactivo /agents se encarga de elegir entre agentes, así como de supervisar y detener los subagentes en ejecución. Ambas vías se complementan: el subcomando sirve para consultar antes de iniciar, el panel para controlar durante la sesión. Este comando se diferencia de agy models, que en cambio lista los modelos disponibles.
✅ ¿CUÁNDO USARLO?
Consultar los agentes personalizados disponibles antes de iniciar
agy agents, para encontrar el nombre exacto para --agent
Seleccionar deliberadamente al iniciar un agente definido globalmente
agy agents muestra code-reviewer; después agy --agent code-reviewer inicia directamente con ese agente
⛔ ¿CUÁNDO MEJOR NO?
Ya se está en una sesión en marcha y se quiere cambiar entre agentes o supervisar subagentes
El subcomando solo entrega una lista puntual fuera de la TUI, pero no una función de selección o supervisión.
Mejor: usar /agents dentro de agy en ejecución
Se buscan los modelos disponibles en lugar de agentes
agy agent/agents lista exclusivamente agentes personalizados, no modelos.
Mejor: usar agy models para listar los modelos disponibles
FUENTES
- Antigravity CLI CHANGELOG (GitHub) ↗ raw.githubusercontent.com
- documentación de Antigravity CLI: /agents ↗ antigravity.google
MÁS COMANDOS · Antigravity CLI