Actualizar ajat

ajat update instala la versión más reciente que incluye tu licencia, desde la propia herramienta. Después de la primera instalación ya no descargas un paquete por cada versión: un solo comando comprueba, descarga, verifica e instala.

Disponible desde ajat v1.0.4. Si ajat update responde “unknown command”, instala una vez v1.0.4 o posterior desde tu página de pedido; a partir de ahí, cada versión nueva llega con update.


ajat update --check        # solo informa; no cambia nada
ajat update                # Linux
sudo ajat update           # macOS

Alias: upgrade, self-update

La actualización se descarga de Climakers usando tu licencia activada, se verifica con la suma SHA-256 generada al compilar la versión y se instala en lugar del binario en ejecución. Solo se envían las credenciales de tu licencia, y solo a Climakers; no necesitas cuenta de GitHub ni ningún otro acceso.

Opciones

Opción	Qué hace
`--check`	Informa si existe una versión más reciente; no cambia nada
`--version`	Instala esta versión, por ejemplo `v1.0.3` — también sirve para volver a una anterior
`--yes`	Instala sin pedir confirmación (obligatorio en CI y scripts)
`--force`	Vuelve a consultar en lugar de usar la caché de 6 horas, reinstala la misma versión o instala el paquete de macOS aunque el binario en ejecución no sea `/usr/local/bin/ajat`
`--format`	`text` (por defecto) o `json` para scripts

Actualizar en macOS

En macOS la actualización es el mismo paquete .pkg firmado y notarizado con el que instalaste, aplicado con el installer de Apple. Instalar un paquete requiere permisos de administrador, así que ejecuta:


sudo ajat update


$ sudo ajat update
Password:
Update ajat v1.0.3 to the latest version? [y/N] y
→ Updating ajat v1.0.3 → v1.0.4 (ajat-v1.0.4-darwin-universal.pkg, 10.3 MB)
  ✓ downloaded and checksum verified
  ✓ installed to /usr/local/bin/ajat
✅ Updated ajat to v1.0.4

Qué hace sudo, y qué no hace:

Solo ejecuta el instalador de Apple. El paquete instala un único archivo, /usr/local/bin/ajat, y registra un recibo que puedes ver con pkgutil --pkgs | grep climakers.
Tu licencia y tu configuración siguen siendo tuyas. Con sudo, ajat lee tu licencia desde tu propia carpeta personal y no escribe nada en ella, así que ningún archivo cambia de propietario.
Olvidar sudo no causa problemas. El comando se detiene antes de descargar nada e indica el comando exacto que debes ejecutar.
Sin avisos de Gatekeeper. El paquete está notarizado por Apple.
Una única ubicación. Si ajat se ejecuta desde otro lugar que no sea /usr/local/bin (por ejemplo, una copia en tu carpeta personal), la actualización se niega, porque el paquete dejaría esa copia sin cambios. Elimina la otra copia o usa --force para instalar igualmente en /usr/local/bin.

Comprueba el resultado con ajat --version.

Actualizar en Linux


ajat update

El binario se reemplaza en su sitio con un único renombrado atómico, así que nunca queda a medio escribir, y un comando de ajat que ya esté en ejecución sigue usando el binario anterior hasta que termina.

La actualización nunca usa sudo en Linux. El directorio que contiene ajat debe poder ser escrito por ti. Si instalaste en /usr/local/bin como root, instala una vez más en un directorio propio, como ~/.local/bin (consulta Instalación y configuración inicial); a partir de ahí las actualizaciones funcionan sin sudo.

Windows no tiene versión publicada, así que update lo indica como no compatible.

Tu suscripción y las versiones anteriores

Mientras tu suscripción está activa, se incluye cada nueva versión. Cuando termina, conservas la versión que tienes y puedes seguir instalando cualquier versión publicada antes de la fecha de finalización:


$ ajat update
❌ Error: your subscription ended on 2026-06-01; this release was published after that

Hint: The last version your license includes is v1.0.3: run 'ajat update --version v1.0.3'. Renew your subscription to receive every new release.

Las licencias locales (sin conexión) también se actualizan, siempre que el archivo de licencia se haya emitido firmado. El servicio de actualización verifica esa firma sin ninguna cuenta de la tienda, y estas licencias descargan desde el almacenamiento de versiones de Climakers. Un archivo emitido antes de que existiera la firma se rechaza con “this local license is not signed”: pide un archivo reemitido y actívalo con ajat license activate --license-file <ruta>. Consulta Licencia.

Comprobaciones, límites y CI

--check responde desde una caché local durante 6 horas. Añade --force para volver a consultar, por ejemplo justo después de que se anuncie una versión.
Las solicitudes están limitadas por licencia (5 instalaciones por hora). El uso normal — una comprobación al día y una instalación por versión — nunca alcanza el límite. Si ocurre, el comando indica cuánto esperar y no envía nada hasta entonces.
Una actualización descargada se conserva 24 horas, así que repetir tras una instalación fallida no la descarga de nuevo.
En CI nadie puede responder a la confirmación, así que update se niega sin --yes. Es preferible fijar la versión que instala tu pipeline (ajat update --version v1.0.4 --yes) en lugar de actualizar en cada ejecución.

Para scripts, --format json imprime el resultado:


{
  "changed": false,
  "checked_at": "2026-09-19T12:00:00Z",
  "current": "v1.0.3",
  "latest": "v1.0.4",
  "update_available": true
}

update no necesita credenciales de Jira y no cuenta para el límite de comandos de tu licencia. La dirección del servicio es la clave de configuración update.endpoint; cámbiala solo si el soporte de Climakers te lo pide.

Si algo falla

Mensaje	Causa	Solución
`installing the macOS package requires administrator rights`	Los paquetes de macOS se instalan con el instalador de Apple, que requiere root	`sudo ajat update`; todavía no se descargó nada
`… is not writable by the current user` (Linux)	El binario está en un directorio propiedad de root	Instala una vez en un directorio propio, como `~/.local/bin`
`this ajat runs from …, but the macOS package installs to /usr/local/bin/ajat`	Hay otra copia de ajat primero en tu `PATH`	Elimina esa copia o usa `sudo ajat update --force`
`too many update requests; try again in …`	Se alcanzó el límite por licencia	Espera el tiempo indicado; en CI fija una versión en lugar de actualizar en cada ejecución
`your subscription ended on …`	La versión se publicó después de que terminara tu suscripción	Instala la versión que indica el mensaje con `--version`, o renueva
`this local license is not signed`	El archivo de licencia es anterior a la firma de licencias	Pide un archivo reemitido y actívalo con `--license-file`
`the update service is unavailable`	Una interrupción temporal	No se cambió nada; inténtalo más tarde

¿Sigues con problemas? Ejecuta el comando con --debug y consulta Soporte.