ReferenciaCLI
vx upgrade
Actualizar vx a la última release y después refrescar con ella el scaffold de vexillum del proyecto
Actualizar vx a la última release y después refrescar con ella el scaffold de vexillum del proyecto.
Uso:
vx upgrade [--channel stable|canary] [--check] [--scaffold-only] [--force] [--yes] [--lang en|es] [--skills | --no-skills]
upgrade trabaja en dos pasos.
1. El binario. Mira cómo se instaló vx:
- Homebrew: corre 'brew upgrade vexillum'.
- El script de instalación (una descarga directa): descarga el archivo de
la release para tu sistema operativo y arquitectura desde GitHub
Releases, verifica su checksum sha256 contra el checksums.txt de la
release y reemplaza el ejecutable de forma atómica, conservando su modo
de archivo. Un checksum que no coincide, o un directorio donde no podés
escribir, detiene el upgrade sin tocar el binario.
- Cualquier otra cosa (un build desde el código fuente, un binario
renombrado): se niega y te dice cómo reinstalar. 'vx upgrade
--scaffold-only' sigue funcionando.
Cuando vx ya está en la última release no se reemplaza nada, y nunca baja
de versión. Un sentinel que esté corriendo nota el binario reemplazado y se
retira; el siguiente comando que necesite uno lo arranca desde el binario
nuevo.
2. El scaffold. Se arranca el binario nuevo para refrescar los archivos del
proyecto, así se aplican sus propias plantillas. Lista los archivos tuyos que
va a cambiar y pide consentimiento primero, igual que 'vx init'. Ver su
ayuda. Después:
- escribe o actualiza el bloque de vexillum en el archivo que lo contiene
(AGENTS.md, o CLAUDE.md cuando el bloque vive ahí), y se asegura de que
CLAUDE.md importe AGENTS.md cuando el bloque está en AGENTS.md. Un bloque
que editaste no se sobrescribe: upgrade imprime el diff entre el tuyo y la
plantilla actual. Un bloque malformado (marcadores desbalanceados o
duplicados) no se toca hasta que confirmes las reparaciones que lista; el
archivo se guarda antes como .vexillum/<file>.backup.
- refresca las skills instaladas que no cambiaron desde que vexillum las
escribió (se guarda un hash del contenido por skill en
.vexillum/config.json) e informa las que editaste. Cuando todavía no hay
ninguna skill instalada ofrece instalarlas, como hace init.
- mantiene al día el hook Stop del sentinel, y crea .vexillum/models.json si
falta. Un models.json existente nunca se sobrescribe, y tus propios hooks
se conservan.
Fuera de un proyecto inicializado solo se actualiza el binario. Sin una
terminal el paso del scaffold no pregunta nada y no hace nada a menos que se
pase --yes.
Flags:
--channel stable|canary
Canal de releases a seguir (por defecto stable). stable es la
última release completa; canary es el último pre-release
cuyo tag contiene -canary. Una instalación con Homebrew solo
sigue stable: para instalar un build canary usá en su lugar
el --channel canary del script de instalación.
--check Imprime la versión disponible y no cambia nada.
--scaffold-only
Refresca el scaffold y deja el binario como está.
--yes, -y Acepta todas las preguntas, incluidas las reparaciones de un
bloque malformado (antes se hace un backup del archivo).
--force Sobrescribe lo que editaste: el bloque de vexillum, una skill
editada. Antes se guarda un backup
(.vexillum/agents-md-slot.backup.md para el bloque,
.vexillum/backups/skills/<name>/ para una skill).
--lang en|es Idioma del bloque, en lugar de conservar el idioma actual del
bloque o detectarlo.
--skills Instala también las skills que faltan.
--no-skills Deja las skills como están: no instala ni refresca.