Configuración

Instale Epismo CLI y conozca sus códigos de entrada, salida y salida JSON.

Comience aquí la primera vez que instale CLI. Una vez configurado, vaya a Authentication para iniciar sesión.

Instalar

npm install -g epismo
epismo --help

El CLI requiere Node.js 18 o posterior. Realiza una verificación de actualización silenciosa aproximadamente una vez al día; configure EPISMO_UPDATE_CHECK=0 para desactivarlo (útil en CI). Cada comando admite --help, al igual que todos los subcomandos, p. epismo pack create --help.

Entrada JSON

Los comandos que toman datos estructurados lo aceptan de tres maneras. Puede pasar JSON en línea, un archivo con @ o stdin con -:

epismo pack create --input '{"type":"context","title":"Runbook","scope":{"type":"personal"}}'
epismo pack create --input @pack.json
cat pack.json | epismo pack create --input -

Los indicadores explícitos anulan los campos cargados desde --input, por lo que puede mantener una plantilla compartida en su repositorio y cambiar solo lo que difiere por ejecución:

epismo track create --input @task.json --title "Override title"

Códigos de salida y salida

El CLI está diseñado para ser codificado:

Los resultados se imprimen en stdout como JSON. Colóquelos directamente en herramientas como jq.
Advertencias y errores van a stderr, para que nunca corrompan el JSON en la salida estándar.
El CLI sale de 0 en caso de éxito y un código distinto de cero en caso de error, por lo que los pasos if epismo …; then y CI detectan errores de manera confiable.

# Capture clean JSON while letting errors surface separately
pack=$(epismo pack get @team-onboarding) || echo "lookup failed" >&2
echo "$pack" | jq '.title'