Introducción
La vez anterior conecté un agente propio a dev-orchestra. Esta vez toca 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
Más tarde (2026-10-29) añadí cómo quitarlo, en la sección Desinstalación. Para eso instalé la 1.3.0 de la misma forma en carpetas aparte y después la quité de verdad.
dev-orchestra está publicado en GitHub (licencia MIT). Si te parece útil, me alegraría mucho que le dieras una estrella.
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.
La tabla para quitarlo está en la sección Desinstalación.
Pasos para actualizar
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 --copyinstall.ps1 -Antigravity -Copyagy plugin install <ruta del checkout>- Ejecutar
install.sh --antigravitydesde Git Bash en Windows (elln -sde 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-orchestraes un enlace (una junction en Windows). Si es una carpeta normal, es una copia. Lo instalado conagy plugin installsiempre es una copia (con agy 1.3.6 se colocó en otro sitio, pero con 1.4.10 fue a la misma~/.gemini/config/plugins/dev-orchestra; cómo distinguirlos al quitarlo está en la sección Desinstalación).
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
Desinstalación
Después de instalar y actualizar, dejo también cómo quitarlo. Esta sección la añadí el 2026-10-29 y la probé aparte de los pasos de actualización, en este entorno:
- Windows 11
- dev-orchestra 1.3.0
- Claude Code 2.1.312
- Codex CLI 0.163.0
- Antigravity CLI (agy) 1.4.10
Igual que con la actualización, instalé la 1.3.0 en carpetas distintas de mi configuración habitual y después la quité. Apunté CLAUDE_CONFIG_DIR en Claude Code, CODEX_HOME en Codex y DEV_ORCHESTRA_HOME para la configuración de dev-orchestra a carpetas de trabajo. Antigravity lee una carpeta dentro de tu carpeta personal (~/.gemini/config/plugins/), así que para probarlo apunté USERPROFILE (HOME en Git Bash) a una carpeta de trabajo.
| CLI / forma de instalación | Cómo quitarlo | Después |
|---|---|---|
| Claude Code | claude plugin uninstall dev-orchestra | Por si acaso, reiniciar Claude Code |
| Codex | codex plugin remove dev-orchestra@dev-orchestra | Por si acaso, empezar una sesión nueva |
| Antigravity (instalado con el instalador) | ./install/uninstall.sh --antigravity (en Windows, .\install\uninstall.ps1 -Antigravity) | Reiniciar Antigravity |
Antigravity (instalado con agy plugin install) | agy plugin uninstall dev-orchestra | Reiniciar Antigravity |
| Instalado desde un checkout | ./install/uninstall.sh (añade --codex para la parte de Codex; en Windows, .\install\uninstall.ps1, con -Codex para la parte de Codex) |
Sea cual sea la CLI, antes de quitar el plugin, quita los hooks del idioma de respuesta y borra la configuración que quieras eliminar (el paso 1 de abajo). El comando de dev-orchestra desaparece junto con el plugin.
1. Antes de quitar el plugin: hooks y configuración
Quita los hooks del idioma de respuesta
Si configuraste language.reply o ejecutaste dev-orchestra hooks install, los hooks de dev-orchestra están en la configuración de Claude Code (settings.json). Estos se quedan aunque quites el plugin. Al ejecutar solo claude plugin uninstall dev-orchestra con los hooks todavía instalados, los tres hooks siguieron en settings.json, y el script intermedio al que llaman también siguió en hooks/, dentro del directorio de configuración de dev-orchestra.
Por eso, quítalos primero, mientras todavía puedas usar el comando de dev-orchestra (también sirve pedirle a Claude Code u otra CLI que “quite los hooks de dev-orchestra”).
$ dev-orchestra hooks uninstall
Removed the reply-language hooks from ...\settings.json
- UserPromptSubmit: ...
- SessionStart: ...
- Stop: ...
deleted: ...\hooks\dev_orchestra_hook.py
deleted: ...\hooks\plugin.json
previous file kept as ...\settings.json.dev-orchestra-backup
El settings.json de antes del cambio se guarda como settings.json.dev-orchestra-backup. Si nunca instalaste los hooks, puedes saltarte este paso (dev-orchestra hooks status muestra Status: not-installed).
Si también quieres borrar la configuración, hazlo ahora
Si ya no vas a usar dev-orchestra y también quieres borrar la configuración, hazlo en este momento.
$ dev-orchestra config reset --scope global --delete
Removed ...\dev-orchestra\config.yaml
Si creaste configuración por proyecto (.dev-orchestra.yaml), ejecútalo con --scope project en la carpeta de ese proyecto y ese archivo se borra.
$ dev-orchestra config reset --scope project --delete
Removed ...\.dev-orchestra.yaml
En ambos casos solo se borra el archivo de configuración. Lo demás que queda está en el paso 6 de abajo.
2. Claude Code
$ claude plugin uninstall dev-orchestra
✔ Successfully uninstalled plugin: dev-orchestra (scope: user)
Desapareció de claude plugin list y también salió de enabledPlugins en settings.json. A diferencia de la actualización, la salida no incluyó un aviso de reinicio (Restart to apply changes.). No probé si una sesión de Claude Code en marcha lo recoge en seguida, así que lo seguro es reiniciar Claude Code.
El marketplace sigue registrado. Si ya no lo necesitas, quítalo también.
$ claude plugin marketplace remove dev-orchestra
✔ Successfully removed marketplace: dev-orchestra
Por cierto, la copia del contenido del plugin (dentro de ~/.claude/plugins/cache/dev-orchestra/) no se borró en ese momento; se quedó en su sitio con un archivo de marca llamado .orphaned_at.
3. Codex
$ codex plugin remove dev-orchestra@dev-orchestra
Removed plugin `dev-orchestra` from marketplace `dev-orchestra`.
codex plugin list pasa a mostrar not installed. El marketplace sigue registrado, así que quítalo si ya no lo necesitas.
$ codex plugin marketplace remove dev-orchestra
Removed marketplace `dev-orchestra`.
Removed installed marketplace root: ...\.tmp\marketplaces\dev-orchestra
Al quitar el marketplace, la instantánea local también se borró.
No probé si una sesión de Codex en marcha lo recoge en seguida, así que lo seguro es empezar una sesión nueva.
4. Antigravity: depende de cómo lo instalaste
Igual que al actualizar, la forma de quitarlo depende de cómo lo instalaste.
Si usaste el instalador
Si lo instalaste con install.sh --antigravity / install.ps1 -Antigravity, ejecuta desde el checkout el desinstalador con la misma opción, tanto si era un enlace como una copia.
.\install\uninstall.ps1 -Antigravity
Removed ...\.gemini\config\plugins\dev-orchestra
Restart Antigravity so that it stops loading the plugin.
The checkout at ...\dev-orchestra was left in place.
En macOS / Linux o en Git Bash es ./install/uninstall.sh --antigravity (en Git Bash probé a instalar una copia y quitarla). El desinstalador solo quita el enlace o la copia que hay dentro de plugins/; el checkout en sí se queda.
Con agy 1.4.10, una copia aparecía en agy plugin list como dev-orchestra (enabled, 1.3.0), y después de quitarla la lista decía No plugins installed. Un enlace (una junction en Windows) no aparecía en agy plugin list ni siquiera antes de quitarlo, así que lo comprobé viendo que la junction de plugins/ había desaparecido.
Si usaste agy plugin install
Si lo instalaste con agy plugin install <ruta del checkout>, quítalo con agy.
$ agy plugin uninstall dev-orchestra
Uninstalled plugin "dev-orchestra"
Con agy 1.4.10, agy plugin install también dejó una copia en la misma ~/.gemini/config/plugins/dev-orchestra. Pero como no la escribió el instalador, uninstall.sh --antigravity no la toca.
.../.gemini/config/plugins/dev-orchestra exists and the installer did not write it; it was left in place.
Remove it by hand if it is no longer wanted.
Si ves este mensaje, usa agy plugin uninstall dev-orchestra.
Sobre el reinicio (lo que no probé)
El README dice que, después de quitarlo, hay que reiniciar Antigravity, y el desinstalador también termina con Restart Antigravity so that it stops loading the plugin. Lo que comprobé esta vez llega hasta agy plugin list y las carpetas; no probé que un Antigravity en marcha deje de cargar el plugin después de reiniciarlo. Sigue el README y reinicia después de quitarlo.
5. Si lo instalaste desde un checkout
Si lo instalaste con el instalador de un checkout, sin pasar por el sistema de plugins de una CLI, quítalo con el desinstalador del mismo checkout.
$ ./install/uninstall.sh
Removed .../skills/dev-orchestra
The checkout at .../dev-orchestra was left in place.
$ ./install/uninstall.sh --codex
Removed the pointer block from .../AGENTS.md
El primero quita la skill de Claude Code (~/.claude/skills/dev-orchestra); el segundo quita solo el bloque de referencia que se añadió al AGENTS.md de Codex. El resto de AGENTS.md se queda. Probé uninstall.sh en Git Bash; uninstall.ps1 en Windows no lo probé con esta forma de instalación.
6. Lo que queda después de quitarlo
Al quitar el plugin, lo siguiente se queda. Si ya no lo necesitas, bórralo tú.
- Configuración: el
config.yamldel directorio de configuración y el.dev-orchestra.yamlde cada proyecto. Cómo borrarlos está en el paso 1 de arriba. Si ya quitaste el plugin, borra los archivos a mano - Tus adaptadores propios:
<directorio de configuración>/providers/.config reset --deletesolo borraconfig.yaml;providers/se quedó tal cual - Artefactos:
.ai/en cada proyecto. Bórralo en cada proyecto donde usaste dev-orchestra, si no lo necesitas
El directorio de configuración es %APPDATA%\dev-orchestra\ en Windows, ~/.config/dev-orchestra/ en macOS y $XDG_CONFIG_HOME/dev-orchestra/ en Linux (~/.config/dev-orchestra/ si no está definido). Si configuraste DEV_ORCHESTRA_HOME, es esa carpeta.
Los pasos también están resumidos en la sección “Uninstalling” del README.
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 conplugin updatedice 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 vezv1.1.1, ogit pullsi 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
doctoruna vez. Tu configuración y tus adaptadores propios se conservan - Para quitarlo, antes de quitar el plugin, ejecuta
dev-orchestra hooks uninstallsi instalaste los hooks del idioma de respuesta, ydev-orchestra config reset --scope global --deletesi también quieres borrar la configuración (--scope projectpara la configuración por proyecto). Después,claude plugin uninstall dev-orchestra/codex plugin remove dev-orchestra@dev-orchestra/ en Antigravity,uninstall.sh --antigravityoagy plugin uninstall dev-orchestrasegún cómo lo instalaste. Si no los borras, la configuración, tus adaptadores propios y.ai/se quedan
La próxima vez pruebo a pasar instrucciones fijas por rol (instructions).
Cuando salga una versión nueva, actualiza con los pasos de este artículo.
GitHub: istb16/dev-orchestra (una estrella siempre se agradece)
Todos los artículos de esta serie están en la lista de artículos de “dev-orchestra”.
Artículos relacionados
Probé dev-orchestra en Antigravity
También instalé dev-orchestra en Antigravity. Funciona sin problemas como el lugar donde hablas, pero encargarle el diseño y la revisión a la CLI de Antigravity (agy) es limitado. Aquí resumo lo que se puede hacer, lo que no y cómo recomiendo usarlo.
Usé solo la revisión de dev-orchestra para enseñar mis cambios locales a varias IA
Cómo usar solo la revisión de dev-orchestra, sin sus etapas de diseño e implementación. Con tres comandos, review snapshot, review run y review show, hice que Claude y Codex revisaran una rama local. También explico cómo elegir --base, las opciones que más uso y cómo lo uso para revisar artículos del blog.
Hice que dev-orchestra revisara una vez más todo el cambio al final
Probé la revisión final de todo el cambio (review.whole_change_recheck) que llegó con dev-orchestra 1.3.0, en un pequeño paquete de Python. Tras una ronda que solo miraba la corrección y no encontró nada, la ronda de todo el cambio encontró un choque entre la corrección y el cambio anterior. Con una corrección que chocaba a propósito, lo detectó antes la ronda de la corrección.