Actualizando dev-orchestra (Claude Code / Codex / Antigravity)

Introducción

La vez anterior conecté un agente propio a dev-orchestra. El último artículo de la serie trata sobre cómo actualizar dev-orchestra a una versión nueva.

Después de la 1.0.0, dev-orchestra ha publicado la 1.1.0 y la 1.1.1. La forma de actualizar depende de la CLI que uses. Por eso probé de verdad el paso de 1.0.0 a 1.1.1 en Claude Code, Codex y Antigravity.

Para la prueba, preparé carpetas distintas de mi configuración habitual, instalé ahí la 1.0.0 y después actualicé (apunté CLAUDE_CONFIG_DIR en Claude Code y CODEX_HOME en Codex a carpetas de trabajo).

• Windows 11
• Claude Code 2.1.301
• Codex CLI 0.163.0
• Antigravity CLI (agy) 1.3.6

Para saber qué hace dev-orchestra, consulta el artículo de presentación.

dev-orchestra está publicado en GitHub (licencia MIT). Si te parece útil, me alegraría mucho que le dieras una estrella.

→ github.com/istb16/dev-orchestra

Primero, la conclusión

CLI	Cómo actualizar	Cuándo surte efecto
Claude Code	claude plugin marketplace update dev-orchestra → claude plugin update dev-orchestra	Reiniciar Claude Code
Codex	codex plugin marketplace upgrade dev-orchestra → codex plugin add dev-orchestra@dev-orchestra	Desde la siguiente sesión
Antigravity (instalado con enlace)	En el checkout, git fetch --tags → git checkout <etiqueta de la versión nueva> (esta vez v1.1.1)	Reiniciar Antigravity
Antigravity (instalado como copia)	Cambia la etiqueta igual y luego ejecuta otra vez el mismo comando de instalación	Reiniciar Antigravity

Con la que más fácil es tropezar es Claude Code: claude plugin update por sí solo no actualizó nada.

Pasos

1. Comprobar la versión actual

En todas las CLI, la lista de plugins instalados muestra la versión.

claude plugin list
codex plugin list
agy plugin list

En Claude Code se ve así (extracto).

  ❯ dev-orchestra@dev-orchestra
    Version: 1.0.0
    Scope: user

La última versión se puede consultar en las releases de GitHub o en el CHANGELOG.

2. Claude Code: actualizar el marketplace y después el plugin

La ayuda dice que claude plugin update “actualiza a la última versión (hace falta reiniciar para aplicarlo)”. Así que primero ejecuté solo ese comando.

$ claude plugin update dev-orchestra
Checking for updates for plugin "dev-orchestra"…
✔ dev-orchestra is already at the latest version (1.0.0).

Dijo que ya estaba en la última versión (1.0.0) y no actualizó nada. La información del marketplace que Claude Code guarda en local seguía siendo antigua, así que no sabía que existía la 1.1.1.

Al actualizar primero el marketplace, esta vez sí se actualizó.

$ claude plugin marketplace update dev-orchestra
✔ Successfully updated marketplace: dev-orchestra

$ claude plugin update dev-orchestra
Checking for updates for plugin "dev-orchestra"…
✔ Plugin "dev-orchestra" updated from 1.0.0 to 1.1.1 for scope user. Restart to apply changes.

Cuando ejecuté solo claude plugin marketplace update, la versión en claude plugin list seguía siendo la 1.0.0. Hacen falta los dos comandos.

Como indica la última línea, al reiniciar Claude Code empieza a usarse la versión nueva.

También se puede hacer desde dentro de una sesión de Claude Code con /plugin, pero esta vez solo probé los comandos que se ejecutan desde el terminal.

3. Codex: renovar el snapshot y volver a añadir el plugin

Codex guarda el marketplace en local como un snapshot. Primero hay que renovarlo.

$ codex plugin marketplace upgrade dev-orchestra
Upgraded marketplace `dev-orchestra` to the latest configured revision.

Después, vuelve a ejecutar el mismo comando que usaste para instalarlo.

$ codex plugin add dev-orchestra@dev-orchestra
Added plugin `dev-orchestra` from marketplace `dev-orchestra`.

$ codex plugin list
dev-orchestra@dev-orchestra  installed, enabled  1.1.1  ...

Con Codex 0.163.0, esta vez el plugin ya había pasado a la 1.1.1 en cuanto ejecuté upgrade. Pero cuando escribí el artículo de Codex, upgrade por sí solo no instalaba la versión nueva, así que lo más seguro es ejecutar también plugin add. No pasa nada por ejecutarlo otra vez.

La versión nueva se usa desde la siguiente sesión que inicies.

4. Antigravity: depende de cómo lo instalaste

Antigravity carga los directorios que hay en la carpeta plugins/. Por eso la forma de actualizar cambia según cómo se colocó ahí.

Si lo instalaste con un enlace

Si enlazaste el checkout del repositorio con install.sh --antigravity (en Windows, install.ps1 -Antigravity), basta con cambiar el checkout a la etiqueta de la versión nueva. En el artículo de Antigravity instalé haciendo checkout de la etiqueta (v1.0.0), así que ahora cambio a la etiqueta de la versión nueva (aquí, v1.1.1).

cd dev-orchestra
git fetch --tags
git checkout v1.1.1

Si tu checkout sigue una rama (main), también sirve git pull.

En Windows, el instalador de PowerShell crea una junction en lugar de un enlace. Al cambiar el checkout de 1.0.0 a 1.1.1, la versión de plugin.json vista a través de la junction también pasó de 1.0.0 a 1.1.1. Esta vez no probé el enlace simbólico de macOS / Linux (solo probé la junction de Windows).

Después, reinicia Antigravity.

Si lo instalaste como copia

Estas formas de instalar dejan una copia:

• install.sh --antigravity --copy
• install.ps1 -Antigravity -Copy
• agy plugin install <ruta del checkout>
• Ejecutar install.sh --antigravity desde Git Bash en Windows (el ln -s de Git Bash crea una copia, no un enlace)

Una copia no cambia aunque cambies el checkout. Cambia la etiqueta igual que en el caso del enlace y luego ejecuta otra vez el mismo comando de instalación.

git fetch --tags
git checkout v1.1.1
./install/install.sh --antigravity --copy

Si lo instalaste desde Windows PowerShell, queda así.

git fetch --tags
git checkout v1.1.1
.\install\install.ps1 -Antigravity -Copy

El instalador reemplaza la copia anterior.

Replaced the existing install at .../.gemini/config/plugins/dev-orchestra
Copied the plugin to .../.gemini/config/plugins/dev-orchestra
Re-run this installer after `git pull` to upgrade.

El mensaje menciona git pull, pero en un checkout que está sobre una etiqueta, en lugar de git pull se cambia la etiqueta como se ha mostrado arriba.

Si lo instalaste con agy plugin install <ruta>, al ejecutarlo de nuevo la versión en agy plugin list también pasó de 1.0.0 a 1.1.1. En ambos casos, termina reiniciando Antigravity.

Si usaste el instalador y no sabes de cuál de las dos formas lo instalaste, comprueba si ~/.gemini/config/plugins/dev-orchestra es un enlace (una junction en Windows). Si es una carpeta normal, es una copia. Lo instalado con agy plugin install se coloca en otro sitio y siempre es una copia.

5. Si lo instalaste desde un checkout

Si lo instalaste directamente desde un checkout, sin pasar por el sistema de plugins de una CLI, el planteamiento es el mismo. En la sección “Upgrading” del README se dice que una instalación desde un checkout se actualiza con git pull. Si tu checkout está sobre una etiqueta, cambia la etiqueta como arriba. Si instalaste con --copy, después vuelve a ejecutar el instalador (references/workflow.md, “Installing from a skill checkout”). Esta forma de instalar no la probé esta vez.

6. Qué comprobar después de actualizar

Ejecuta dev-orchestra doctor una vez (pedirle a Claude Code u otro agente que “ejecute el doctor de dev-orchestra” funciona igual). Comprueba que tus CLI, tu configuración y tus modelos siguen estando bien con la versión actual. Si aparece No problems found., todo va bien, pero lee también los avisos que aparezcan debajo. Como en el ejemplo de abajo, puede aparecer un aviso de que se ignoró un ajuste.

En mi entorno de prueba apareció esta diferencia. Mi archivo de configuración ya tenía design.ask_questions, un ajuste añadido en la 1.1.0. El doctor de la 1.0.0 lo señalaba como un ajuste desconocido, y en la 1.1.1 el aviso desapareció.

== 1.0.0
No problems found.
  - design.ask_questions in the global file: unknown key, ignored
== 1.1.1
No problems found.

También conviene saber lo siguiente:

• Tu configuración y tus adaptadores propios se conservan. La configuración (config.yaml) y tus adaptadores propios (<directorio de configuración>/providers/) están en el directorio de configuración, fuera del plugin. Siguen igual al actualizar el plugin
• Échale un vistazo al CHANGELOG. La configuración, los artefactos y los comandos se mantienen compatibles mientras la versión mayor sea la misma. Si hay algún cambio que requiera tu atención, está escrito en el CHANGELOG
• Las funciones nuevas suelen seguir desactivadas hasta que las actives tú. Por ejemplo, la función de “hacer preguntas antes del diseño” añadida en la 1.1.0 (design.ask_questions) está desactivada al principio. Actualizar no cambia por sí solo cómo ha funcionado todo hasta ahora

Resumen

• La versión actual se ve con claude plugin list / codex plugin list / agy plugin list
• Claude Code: claude plugin marketplace update dev-orchestra → claude plugin update dev-orchestra → reiniciar. Solo con plugin update dice que ya está en la última versión y no actualiza
• Codex: codex plugin marketplace upgrade dev-orchestra → codex plugin add dev-orchestra@dev-orchestra. Se usa desde la siguiente sesión
• Antigravity: si es un enlace, cambia el checkout a la etiqueta de la versión nueva (git fetch --tags → git checkout <etiqueta de la versión nueva>, esta vez v1.1.1, o git pull si sigues una rama). Si es una copia, después vuelve a ejecutar el comando de instalación. En ambos casos, reinicia
• Después de actualizar, ejecuta doctor una vez. Tu configuración y tus adaptadores propios se conservan

Con esto termina la serie. Para leerla desde el principio, empieza por el artículo de presentación; para verlo todo junto, usa la lista de artículos de “dev-orchestra”. Cuando salga una versión nueva, actualiza con los pasos de este artículo.

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