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.