Licencia

ajat es software comercial de Climakers. Los comandos operativos como export, report, diff, search, import, rule e invoke requieren una licencia válida. Los comandos de configuración y diagnóstico (config, doctor, license, support, tree, version, completion y la ayuda) se ejecutan sin ella.

La gestión de la licencia se realiza mediante el grupo de comandos license. Esta es la primera dependencia que debe validarse en una máquina nueva antes de iniciar cualquier flujo de inventario, exportación o revisión de gobierno.

Compra ajat y compara todas las ediciones comerciales en store.climakers.com/ajat, la tienda de Climakers en Lemon Squeezy. La licencia está vinculada a la máquina donde se activa.

Dónde se almacenan las licencias

Las licencias se cifran con AES-256-GCM usando una clave derivada de la máquina y se almacenan en el directorio estándar de configuración de usuario de la plataforma:

Plataforma	Ruta
macOS	`~/Library/Application Support/ajat/license.bin`
Linux	`~/.config/ajat/license.bin`

Muestra la ruta resuelta con:


ajat license where

Como la clave de cifrado está vinculada a la máquina, copiar license.bin de un dispositivo a otro no funciona — hay que desactivar la máquina antigua y volver a activar en la nueva.

Los archivos de licencia están vinculados a la máquina por diseño. No trates license.bin como un secreto portable que puedas entregar a otra estación de trabajo; trátalo como un registro de activación local. Para mover una licencia, desactívala aquí y actívala allí.

license activate

Activa ajat con una clave de licencia comprada o con un archivo de licencia local para uso sin conexión.

Clave emitida por LemonSqueezy (recomendado)

Tras la compra recibes una clave de licencia UUID v4. Actívala con --license-key:


ajat license activate --license-key 38b1460a-5104-4067-a91d-77b872934d51

Esto llama a la API de LemonSqueezy para registrar esta máquina y escribe el archivo de licencia cifrado localmente.

Archivo de licencia sin conexión (acuerdos de partner, sitios aislados)

Para entornos sin acceso a Internet, el soporte de Climakers puede emitir un archivo de licencia preactivado. Impórtalo con --license-file:


ajat license activate --license-file ./acme-ajat-license.bin

El archivo debe emitirse para esta máquina exacta — la clave de cifrado se deriva de tu ID de hardware, por lo que los archivos generados para otra máquina se negarán a descifrarse.

Si ya hay una licencia activa, pasa --force para reemplazarla o ejecuta antes ajat license deactivate. Si tu licencia actual está caducada y tienes una clave renovada (diferente), no necesitas desactivar — ejecutar ajat license activate --license-key <nueva-clave> reemplaza automáticamente el archivo local caducado con la licencia recién activada.

Valida el resultado inmediatamente después de activar:


ajat license validate

Variantes

ajat se comercializa en cinco ediciones. Las licencias instaladas de LemonSqueezy se validan automáticamente antes de cada comando no exento, pero una validación en línea contra la API no se dispara en cada ejecución. Para licencias en línea, la validación mediante la API se produce cuando se alcanza cualquiera de los umbrales siguientes, lo que ocurra primero.

Variante	Caso de uso	Cadencia de validación
Trial	Evaluación de 14 días, funciones completas	cada 2 días / 50 comandos
Solo	Usuario único, uso comercial	cada 7 días / 50 comandos
Team	Licencia de equipo multiusuario	cada 10 días / 100 comandos
CI/CD Automation	Solo pipelines de CI/CD	ventana diaria stateless de 4 horas
Enterprise	Inventario, retención de exportaciones y revisiones de gobierno a nivel de organización	cada 14 días / 100 comandos

Si la máquina está sin conexión cuando toca validar mediante la API, ajat recurre a la validación local y sigue funcionando con normalidad. La comprobación en línea se reintenta en una ejecución posterior cuando vuelve la conectividad. Ejecuta ajat license validate --force cuando quieras forzar la comprobación en línea de inmediato.

Variante CI/CD Automation

Esta variante es obligatoria al ejecutar ajat desde un pipeline de CI/CD. Esta variante:

Rechaza el uso fuera de un entorno de CI reconocido (detectado mediante las variables de entorno CI / GITHUB_ACTIONS / GITLAB_CI / … y un stdin no interactivo).
Valida de forma stateless mediante una programación basada en hash SHA-256 sobre la clave de licencia y el día de la semana actual. Esto evita saturar la API de LemonSqueezy en cada ejecución del pipeline sin dejar de validar al menos una vez por semana.

Si intentas usar una licencia CI/CD en un escritorio interactivo, ajat devuelve un LicenseCICDEnvironmentRequiredError con una sugerencia para elegir otra variante. A la inversa, las variantes de escritorio están pensadas para uso interactivo, no para pipelines.

Compra o compara las ediciones Trial, Solo, Team, CI/CD Automation y Enterprise en store.climakers.com/ajat. La Trial es una evaluación gratuita de 14 días con todas las funciones.

license list

Muestra los detalles de licencia almacenados que conoce la instalación local.


ajat license list               # salida de tabla predeterminada
ajat license list --format yaml # YAML
ajat license list --format json # JSON
ajat license list --format csv  # CSV (una sola fila)

Alias: ls, show, status, info.

La salida muestra tipo, estado, variante, cliente, clave enmascarada, expiración, uso de activación, número de comandos desde la última validación y la marca de tiempo de la última validación exitosa. La clave de licencia siempre se enmascara en la salida y los campos sensibles como los límites de activación se excluyen, por lo que el resumen es seguro para pegar en un caso de soporte.

license where

Muestra la ubicación en disco del archivo de licencia cifrado.


ajat license where

Es útil cuando necesitas confirmar la ubicación de la licencia vinculada a la máquina antes de una copia de seguridad, una restauración o una incidencia de soporte.

license validate

Ejecuta la misma comprobación de licencia que realizan los comandos protegidos, sin ejecutar ninguna operación destructiva.


ajat license validate          # ejecuta la comprobación contra el estado local
ajat license validate --force  # fuerza una llamada inmediata a la API de LemonSqueezy

--force es útil después de activar una nueva licencia o al resolver un problema de red — omite los umbrales locales y valida contra la tienda de inmediato. Las licencias locales (sin conexión) siempre se comprueban sin acceso de red.

Motivos habituales para ejecutar license validate:

inmediatamente después de activar una máquina nueva
antes de que arranque un flujo recurrente de exportación o generación de informes
después de restaurar una máquina desde copia de seguridad o tras migrar el perfil
cuando una activación anterior se desactivó o podría haber caducado

license deactivate

Libera la licencia: llama a la API y elimina el archivo local.


ajat license deactivate          # llama a la API y elimina el archivo local
ajat license deactivate --force  # elimina el archivo local aunque falle la desactivación por API

--force es la salida de emergencia cuando la API rechaza la desactivación — por ejemplo, la instancia ya se eliminó de forma remota (404) o la licencia ha alcanzado un estado terminal como expired o disabled (400). El espacio de activación en el lado remoto ya está libre o ya no es utilizable, así que el archivo local es lo único que queda por limpiar.

Ejecuta este comando antes de retirar una máquina, reconstruirla o mover deliberadamente la licencia operativa a otra estación de trabajo. Una desactivación limpia es más segura que dejar activaciones obsoletas y descubrir el problema durante una exportación urgente.

Copia de seguridad y restauración de una licencia

El archivo de licencia cifrado está vinculado a tu máquina. Para protegerte frente a la pérdida del disco o una reinstalación del sistema, haz una copia con license export y restáurala más tarde con license import.


# Respaldar la licencia actual
ajat license export --file ~/backup/ajat-license.bin
ajat license export --file ~/backup/ajat-license.bin --overwrite
 
# Restaurar la copia más tarde
ajat license import --file ~/backup/ajat-license.bin
ajat license import --file ~/backup/ajat-license.bin --force   # sobre una licencia existente

Como la clave de cifrado se deriva de identificadores de hardware, el archivo de respaldo solo puede importarse de nuevo en la misma máquina que lo exportó. Los flujos de traslado a otra máquina requieren desactivar la máquina antigua y volver a activar con --license-key en la nueva.

Al importar con --force sobre una licencia local existente, el número de comandos y la marca de tiempo de la última validación se conservan si son mayores que los valores importados. Esto evita reiniciar los contadores de cumplimiento mediante un ciclo de exportación/importación.

Trata las licencias exportadas como activos sensibles vinculados a máquina. Guárdalas en los mismos entornos protegidos que usarías para otros secretos operativos y materiales de recuperación.

Privacidad

La solicitud de validación de LemonSqueezy solo transporta tu clave de licencia y el ID de activación por máquina. Ningún dato de Jira, salida de comandos, contenido de reglas de automatización, informe de inventario ni topología de la organización sale de tu máquina.

Flujo operativo recomendado

Para una máquina o runner nuevos, la secuencia más segura es:

activar la licencia con ajat license activate
confirmar la activación con ajat license validate
registrar la ubicación instalada con ajat license where
ejecutar ajat doctor para validar el estado completo del puesto
exportar una copia de respaldo con ajat license export cuando la máquina pase a formar parte de un flujo de producción

Esto mantiene activación, verificación, diagnóstico y capacidad de recuperación dentro del mismo flujo operativo en lugar de tratar la licencia como un detalle aislado de configuración.

¿Necesitas ayuda?

Si la activación o la validación de licencia fallan:

vuelve a ejecutar ajat license validate
confirma la ubicación instalada con ajat license where
ejecuta ajat doctor
genera un paquete de soporte con ajat support --output support-bundle.txt

Incluye la salida de ajat license list y ajat license where cuando contactes con support@climakers.com. El acuerdo de licencia completo está disponible en la página de Términos de Licencia, y el flujo de diagnóstico está documentado en la página de Soporte.