CLI

La CLI epismo cubre guías, versiones, casos, tareas, registros, sugerencias, alias, estrellas, espacios de trabajo, proyectos, miembros, créditos y tokens de automatización. La salida exitosa es JSON en la salida estándar; Las advertencias y fallas tienen formato JSON en stderr para que las personas y los agentes puedan usar los mismos comandos de manera segura.

Instalar e iniciar sesión

Se requiere Node.js 22.12 o posterior.

npm install -g epismo
epismo login
epismo whoami

epismo login --email you@example.com descubre primero el SSO de la organización y, de lo contrario, completa el inicio de sesión con código de correo electrónico en la terminal. El inicio de sesión del navegador se utiliza cuando corresponde. Las credenciales se almacenan localmente y se actualizan antes de que caduquen; use epismo logout antes de cambiar de cuenta.

Contexto de ejecución

Cada comando resuelve un contexto de espacio de trabajo:

1. Cuando se configura EPISMO_TOKEN, el espacio de trabajo integrado en ese token tiene autoridad y se ignora el valor predeterminado guardado.
2. De lo contrario, epismo workspace use <workspace-id> selecciona el valor predeterminado guardado.
3. Sin ninguno de los dos, los comandos utilizan el espacio personal.

epismo workspace list
epismo workspace use <workspace-id>
epismo workspace current
epismo workspace clear

Para CI, cree un token con ámbito de espacio de trabajo, guárdelo en un administrador secreto, inyéctelo como EPISMO_TOKEN y ejecute epismo whoami al inicio del trabajo para verificar la identidad y el contexto.

Entrada estructurada y reintentos seguros

Los comandos de carga útil aceptan un objeto JSON en línea, @file o - para stdin. Las banderas explícitas anulan los campos coincidentes de --input.

epismo playbook create --input @playbook.json
epismo record append <case-id> --input @record.json
epismo suggestion create --input - < suggestion.json

Los comandos de mutación generan un UUID de idempotencia cuando se omiten. Proporcione y reutilice un --idempotency-key explícito solo cuando vuelva a intentar una solicitud idéntica cuyo resultado sea incierto. Los cambios de estado de casos y tareas también requieren la última versión de --lock-version; Después de un conflicto, lea el estado actual antes de decidir qué hacer.

Continúe con Playbooks, Casos y transferencias, Entrada y salida, Administración y CI o la referencia de comando.