Comandos de configuración

El grupo config te permite inspeccionar y gestionar la configuración activa de ajat sin editar YAML a mano.

Estos comandos son útiles para preparar estaciones de trabajo repetibles, pipelines de CI y escenarios de soporte donde necesitas un rastro claro de los cambios de configuración. Los valores sensibles como jira.api_token siempre se anonimizan al mostrarse.

La familia de comandos config está disponible antes de la activación de la licencia o de la configuración completa de credenciales, así que puedes preparar una máquina antes de que esté completamente aprovisionada.

config create

Crea un nuevo archivo de configuración en la ubicación predeterminada, rellenado con todos los ajustes disponibles y sus valores por defecto. Los valores sensibles como jira.api_token se dejan en blanco para que los completes después.

ajat config create

Si ya existe un archivo de configuración, el comando se detiene y lo deja intacto. Pasa --force (-f) para sobrescribirlo y restablecer los valores por defecto.

ajat config create --force

config where

Muestra la ruta absoluta al archivo de configuración activo. El comando imprime la ruta exista o no el archivo.

ajat config where

Ejemplo de salida:

/Users/alice/Library/Application Support/ajat/config.yaml

Flags

# Falla si el archivo aún no existe
ajat config where --exists
 
# Abre el archivo en tu editor
$EDITOR "$(ajat config where --shell-escape)"

config list

Muestra la configuración efectiva completa como YAML, incluidos los valores cargados desde variables de entorno AJAT_ y flags de CLI.

ajat config list

Úsalo cuando necesites inspeccionar la configuración efectiva y no solo los valores escritos en disco.

Ejemplo de salida

debug:
    dir: debug
    enabled: false
http:
    client:
        base_timeout: 1s
        max_retries: 3
        max_timeout: 30s
        proxy: ""
jira:
    api_token: AT************************************************************3D
    domain: <tenant>.atlassian.net
    type: cloud
    username: <user>@<domain>
log:
    file: ""
    format: text
    level: info

El token API se anonimiza automáticamente en la salida, así que el resultado es seguro para compartir al reportar un problema o revisar tu instalación. El resto de valores se muestran tal cual.

config get

Recupera el valor efectivo de una única clave de configuración, impreso como fragmento YAML. Las claves usan notación de puntos. La clave puede pasarse como argumento o canalizarse por la entrada estándar.

ajat config get KEY

Ejemplos

ajat config get jira.domain
ajat config get log.level
ajat config get http.client.max_retries
 
# Lee la clave desde la entrada estándar
echo "jira.domain" | ajat config get

El valor devuelto es el que ajat usará realmente tras aplicar su precedencia: flags de CLI, luego variables de entorno AJAT_, luego el archivo de configuración y finalmente los valores por defecto. jira.api_token se anonimiza.

config set

Guarda un valor de configuración en el archivo de configuración en disco. Las claves usan notación de puntos y el valor se escribe literalmente. Si el archivo de configuración aún no existe, se crea con valores por defecto antes de escribir el valor.

ajat config set KEY VALUE

Ejemplos

# Credenciales de Jira Cloud
ajat config set jira.domain acme.atlassian.net
ajat config set jira.username you@acme.com
ajat config set jira.api_token YOUR_API_TOKEN
 
# Logging
ajat config set log.level debug
ajat config set log.format json
ajat config set log.file /var/log/ajat.log
 
# HTTP
ajat config set http.client.max_retries 5
ajat config set http.client.proxy "http://proxy.corp.example.com:8080"

Las variables de entorno AJAT_ y los flags de línea de comandos siguen teniendo prioridad sobre lo que guardes aquí.

Claves de configuración disponibles

config validate

Comprueba la configuración efectiva en busca de problemas sin contactar con Jira ni hacer ninguna llamada de red. Termina con 0 cuando la configuración es válida y con un código distinto de cero, con un mensaje accionable, cuando no lo es, lo que lo convierte en una buena barrera para scripts de configuración y pipelines de CI.

ajat config validate

Añade --require-credentials para confirmar además que jira.domain, jira.username y jira.api_token están definidos — la misma comprobación que ejecutan los comandos de exportación y de reportes antes de conectarse a Jira.

ajat config validate --require-credentials

Flujo recomendado

1. ejecuta ajat config create
2. define los valores de conexión con Jira usando config set
3. compruébalos con config get o config list
4. ejecuta ajat config validate --require-credentials
5. ejecuta ajat doctor

Consulta Configuración para el modelo completo de precedencia, la tabla de variables de entorno AJAT_ y la configuración del proxy, y Utilidades para doctor y el resto de los comandos de diagnóstico.