tk3.biz

Introducción

La última vez usé dev-orchestra con Codex, y antes con Claude Code. Esta vez le toca a Antigravity, de Google.

Voy a adelantar la conclusión.

  • Hablar con dev-orchestra desde Antigravity funciona sin problemas
  • Sin embargo, encargarle el diseño y la revisión a la CLI de Antigravity (agy) es limitado
  • Lo que recomiendo: hablar con él en Antigravity y dejar que Claude o Codex hagan el trabajo

Lo que hace dev-orchestra lo conté en el artículo de presentación.

dev-orchestra está publicado en GitHub (licencia MIT). Si te parece útil, una estrella me haría mucha ilusión.

→ github.com/istb16/dev-orchestra

Qué funciona y qué no

Para evitar decepciones, aquí va primero el resumen.

SoporteNotas
Usar dev-orchestra desde AntigravitySíSi lo instalas como plugin, funciona con solo hablarle
Encargar el trabajo a Claude / CodexSíSi están instalados, el trabajo se les asigna automáticamente
Que agy implemente y corrijaSíPara ejecutar tests hace falta una configuración
Que agy diseñe y reviseParcialNo se puede forzar el modo de solo lectura, así que el soporte es limitado y con advertencia
Instalar desde el MarketplaceNoSe clona y se instala mediante un enlace

Antes de seguir, aclaro los dos nombres que aparecen aquí.

  • Antigravity: la aplicación con la que hablas. dev-orchestra se instala aquí como plugin
  • agy: la CLI de Antigravity. Es uno de los agentes a los que dev-orchestra asigna el diseño, la implementación y la revisión

“El lugar donde hablas” y “la IA que hace el trabajo” son cosas distintas, y las limitaciones solo se aplican cuando usas agy como lo segundo.

Qué necesitas

ElementoNotas
AntigravityCon la sesión ya iniciada
Python 3.11 o superiorFunciona solo con la biblioteca estándar
gitSe usa para clonar y para obtener el diff que se va a revisar
Claude Code o CodexNo son obligatorios, pero si los tienes se les puede encargar el trabajo (recomendado)

Pasos

1. Instalar

El Marketplace de Antigravity lo selecciona Google y no puedes añadir nada por tu cuenta. Por eso, clona el repositorio y enlázalo en la carpeta de plugins de Antigravity.

git clone https://github.com/istb16/dev-orchestra.git
cd dev-orchestra
git checkout v1.0.0
./install/install.sh --antigravity

En PowerShell de Windows, la última línea queda así.

.\install\install.ps1 -Antigravity

Después de instalar, reinicia Antigravity. Los plugins nuevos solo se cargan al arrancar.

Al instalarlo mediante un enlace, se carga tal cual el contenido de la carpeta clonada. Por eso recomiendo hacer checkout de la etiqueta de la versión (v1.0.0) antes de instalar. Si no quieres que cambie el contenido de la carpeta, puedes instalarlo como copia con --copy (-Copy en Windows). En Windows se crea una junction, así que no hace falta el Modo de desarrollador.

2. Elegir un preset la primera vez

A partir de aquí es igual que con Claude Code y Codex. La primera vez que haces una petición que usa dev-orchestra, te pregunta por un preset. Si dudas, standard está bien.

3. Si Claude Code también está instalado (recomendado)

Con Claude Code también instalado en la misma máquina que Antigravity, la configuración quedó así (extracto de config show en dev-orchestra 1.0.0).

Preset: standard (implicit; fitted to claude, agy)

  Architect
    claude / fable / latest
  Implementer
    claude / opus / latest
  Reviews
    1. claude / opus / latest / general / claude-general
    2. claude / sonnet / latest / general / claude-general-2
    3. claude / sonnet / latest / security / claude-security (opus when high-risk)
    4. claude / sonnet / latest / test / claude-test

agy no tiene ningún rol. El diseño, la implementación y la revisión los hace todo Claude.

Esta es la configuración que más recomiendo.

  • Hablas con Antigravity (tu pantalla de siempre)
  • Claude hace el trabajo (el modo de solo lectura se puede forzar correctamente)

Si Codex también está instalado, Codex se suma a las revisiones, igual que la última vez.

4. Si solo está instalado agy

Si no hay ni Claude Code ni Codex instalados, todos los roles pasan a agy. La configuración quedó así (extracto).

Preset: standard (implicit; fitted to agy)
  note: claude, codex not found on PATH: architect went to agy (default); agy cannot be held to reading -- set architect in the global file to keep it off agy
  note: claude, codex not found on PATH: reviewer seat 2 (general) was not added; it would repeat agy-general
  note: claude, codex not found on PATH: reviewer seat 3 (security) was not added; agy cannot be held to reading
  note: claude, codex not found on PATH: reviewer seat 4 (test) was not added; agy has no cheap model named offline

  Architect
    agy / default / latest
  Implementer
    agy / default / latest
  Reviews
    1. agy / default / latest / general / agy-general

Hay dos cosas a las que conviene prestar atención.

  • Solo hay un revisor. Un segundo revisor general sería el mismo agy que el primero, así que no se añade. El puesto de seguridad no se cubre porque no se puede forzar el modo de solo lectura. Tampoco se añade el de tests, ya que en agy no se puede indicar por nombre un modelo barato
  • Las líneas que asignan el diseño o la revisión a agy llevan la advertencia agy cannot be held to reading (no se puede obligar a agy a limitarse a leer)

Funciona, pero se pierde buena parte de lo que hace valioso a dev-orchestra (que otra IA lea y revise sin reescribir nada). Si solo tienes agy, te recomiendo añadir Claude Code o Codex.

5. Comprobar que todo está listo

Pídele al agente “Ejecuta el doctor de dev-orchestra”. La parte de agy salió así (extracto).

Antigravity CLI (agy)
  Installed: yes
  Model selection: supported
  Read-only runs: NOT ENFORCED (runs allowed, warned) -- agy cannot be held to reading only: ...
  Resume: NOT SUPPORTED -- agy does not resume sessions

NOT ENFORCED significa que cuando agy diseña o revisa, se ejecuta en un estado en el que puede modificar archivos. dev-orchestra no puede impedirlo, así que lo ejecuta con una advertencia.

Si al final aparece No problems found., ya está todo listo.

6. Hacer la petición en una frase

A partir de aquí, basta con hablarle como en cualquier otro entorno.

Implementa este issue con el flujo de trabajo configurado

El flujo desde la aprobación del plan hasta el informe final es el que describí en el artículo de Claude Code.

Funciones y limitaciones propias de Antigravity

Lo que conviene saber al usar agy como agente de trabajo (a fecha de dev-orchestra 1.0.0; los detalles están en providers.md).

Detalles
Precaución: no se puede forzar el solo lectura en diseño y revisiónSe ejecuta pudiendo modificar el árbol de trabajo y .ai/ (incluidos los registros de aprobación). Solo se acepta desde la configuración global, con advertencia
Precaución: como implementador, no puede ejecutar tests de entradaSe rechazan los comandos de shell. Si pones options.skip_permissions: true en la configuración global, se ejecutan (consulta la nota de abajo)
No disponible: no puede retomar el diseño donde se quedóIncluso al revisar el plan, se ejecuta de cero cada vez
Precaución: tarda en darse cuenta de que un agente se ha atascadoA diferencia de las demás CLI, no hay un tiempo límite de inactividad. Espera hasta alcanzar el límite de tiempo total
Precaución: consumo alto de tokens por ejecuciónIncluso una petición pequeña supone unos 12 000–25 000 tokens de entrada
Ventaja: dejar el modelo a agy o indicarlo por nombre de familiaPor defecto es default (lo elige agy). También puedes indicar un nombre de familia como gemini-flash / gemini-pro
Precaución: la instalación y la actualización son manualesSe instala mediante un enlace y hay que reiniciar Antigravity tras instalar o actualizar

Al poner options.skip_permissions: true, a agy se le añade --dangerously-skip-permissions. Se salta las confirmaciones de permiso de agy para todos los comandos de shell, no solo los de test. Actívalo solo si lo entiendes.

El contenido de los archivos que lee agy se envía a Google. Como tampoco se puede forzar el solo lectura, puede leer archivos secretos como .env. Lo más seguro es dejar los archivos secretos fuera de su alcance, o revisar ese tipo de código con un LLM local (lo mencioné en el artículo de presentación).

dev-orchestra no puede comprobar si has iniciado sesión. Si las ejecuciones de agy fallan, prueba a abrir agy una vez e iniciar sesión.

Resumen

  • En Antigravity se instala clonando y enlazando (reinicia después de instalar)
  • Funciona sin problemas como lugar donde hablas. Puedes ejecutar dev-orchestra desde tu pantalla de siempre
  • Si Claude Code o Codex también están instalados, el trabajo se les asigna automáticamente. Es lo que recomiendo
  • Encargarle el diseño y la revisión a agy es limitado. Como no se puede forzar el solo lectura, viene con advertencia
  • Si solo tienes agy, añadir Claude Code o Codex saca partido a lo que hace bueno a dev-orchestra

El uso detallado está en el README. Con esto queda cubierto el uso en los tres entornos. A partir del próximo artículo entraré en la configuración, como los presets y la forma de organizar a los revisores.

Para saber cómo actualizar cuando salga una versión nueva, mira Actualizar dev-orchestra.

Todos los artículos de esta serie están en la lista de artículos de “dev-orchestra”.

GitHub: istb16/dev-orchestra (una estrella siempre se agradece)

Artículos relacionados