El CLI styx objetivo, agrupado por área, con qué decisión define cada comando. Referencia escrita a mano hasta que exista la generada.
Especificado. Hoy existen en
apps/clilos comandos de instalación y operación del servidor (install,update,rollback,status,backup,doctor,render) y los de acceso (login,logout,whoami,token,device: ver entrar con el CLI), además destyx-upload(subir ficheros). El resto de la API sigue por hacer. Cuando exista el CLI completo, la referencia exacta (referencia/cli) se genera del registro de operaciones y esta página pasa a enlazarla.
Hay un solo binario, styx, que sirve para instalar y operar el servidor y para usar la API.
Cada cosa que hace la interfaz web existe como operación de la API y como comando. Reglas
comunes en salida JSON y códigos de salida.
La columna "Fuente" distingue lo que ya está en un ADR (aunque sea PROPOSED) de los nombres
provisionales, que fija el ADR de headless (docs/track/docs/tickets/12.md).
| Grupo | Comandos | Fuente |
|---|---|---|
| Instalación | install, update, rollback, status, doctor, logs, config, secrets rotate, channel, self-update, uninstall, render, verify | dec-0123 D6 |
| Copias | backup create, backup list, backup restore, backup prune | dec-0123 D6 |
| Sesión | login [--server URL], login --with-token, auth status, auth methods, auth switch-profile, logout [--all] | dec-0125 §10-11 |
| Cuentas | account list|show|update|set|delete, profile list|create|update|delete, profile pin set|clear | dec-0125 §11 |
| Hogares | household create|show|update|delete|leave, household member set|remove | dec-0125 §11 |
| Invitaciones | invite create|list|show|revoke|inspect | dec-0125 §11 |
| Claves y dispositivos | key create|list|revoke|rotate, device list|approve|revoke, server setup | dec-0125 §9-11 |
| Biblioteca | library root set, library embed [--dry-run], library embed status, library prepare, library import nfo | dec-0126 §9 |
| Biblioteca (resto) | añadir raíz, escanear, listar, subir | Provisional: nombres por fijar en el ADR de headless |
| Servidor | server … (estado, salud, configuración de runtime) | Provisional |
styx install y styx update son transacciones: el resumen de pasos, el rollback y el
--dry-run están en Instalar y Actualizar.--dry-run.argv, que cualquiera ve en ps.styx login usa el flujo de autorización de dispositivo
(conectar la TV y el CLI); en scripts, una
API key.