CLI independiente
El comando reks 0.2.0 permite consultas y operaciones explícitas del operador. Se instala fuera del monorepo y de las aplicaciones consumidoras.
En esta página
Instalar el archivo correcto
@reks/cli 0.2.0 · Node.js 22+ · sh
# Usa una instalación de Node de tu usuario; no requiere la app cliente. npm install --global --ignore-scripts ./distribuciones/reks-cli-0.2.0.tgz reks --help
Requiere Node.js 22+ y el tarball privado verificado. El bin real del paquete @reks/cli se llama reks. La instalación no depende de desplegar una aplicación cliente ni instala un servidor MCP.
--help es la referencia de comandos de tu archivo instalado. No asumas que un comando de un README histórico o un wrapper interno del monorepo existe en esa versión.
Autenticación con alcance explícito
@reks/cli 0.2.0 · dotenv
# reks.local.env — fuera de Git. Sustituye todos los marcadores. REKS_CONSOLE_URL=https://console.example.test REKS_OPERATOR_EMAIL=TU_CORREO_DE_OPERADOR REKS_OPERATOR_PASSWORD=TU_CREDENCIAL_LOCAL
Guarda el archivo fuera de Git, privado y bajo tu usuario; en Unix usa chmod 600. Su REKS_CONSOLE_URL debe coincidir exactamente con --origin. Las contraseñas no son argumentos de comando y la CLI no persiste cookies. No uses credenciales de base de datos, hosting o repositorio como sustituto.
El operador autenticado es la identidad que autoriza. Un nombre de agente es procedencia autodeclarada; no concede permisos. Cada operación cierra su sesión temporal. No ejecutes la CLI contra producción sólo para probar la instalación.
Comienza con consultas
@reks/cli 0.2.0 · sh
chmod 600 reks.local.env reks doctor --origin https://console.example.test \ --credentials ./reks.local.env --project-id TU_PROYECTO reks signals:permissions --origin https://console.example.test \ --credentials ./reks.local.env --project-id TU_PROYECTO reks signals:list --origin https://console.example.test \ --credentials ./reks.local.env --project-id TU_PROYECTO reks signals:read --origin https://console.example.test \ --credentials ./reks.local.env --project-id TU_PROYECTO --signal-id TU_REPORTE
| Comando | Uso |
|---|---|
| capabilities / doctor | Compatibilidad de cliente/servidor y funciones dentro del proyecto autorizado. |
| signals:permissions | Permisos efectivos propios para el proyecto. |
| signals:list / read | Ventana acotada de reportes o un reporte autorizado. |
| signals:export / activity | Contexto acotado para revisión e historial autorizado; no ejecución. |
| grants:list | Permisos propios; consultar otra cuenta requiere su autoridad específica. |
| integration:read | Una revisión de configuración con scope JSON explícito y autorización. |
Esta CLI 0.2.0 no acepta ese flag. Usa comandos de lectura para inspeccionar. integration:draft escribe un borrador revisable en servidor; no es una simulación sin efectos. El runner dry-run interno del repositorio no se exporta como comando reks en esta versión.
Escrituras y confirmaciones
@reks/cli 0.2.0 · json
{"text":"Nota revisada del equipo con contexto no sensible."}@reks/cli 0.2.0 · sh
# Revisa primero el JSON, tu permiso y el alcance de la operación. # Usa el mismo action-id sólo para esa operación idéntica revisada. reks signals:note --origin https://console.example.test \ --credentials ./reks.local.env --project-id TU_PROYECTO --signal-id TU_REPORTE \ --input ./nota-revisada.json --action-id TU_ID_ESTABLE --confirm # --confirm no sustituye autorización. No reintentes automáticamente una escritura # cuyo resultado sea ambiguo. Este comando NO cierra ni aprueba el reporte.
signals:note, draft, feedback y transition requieren input acotado, action-id estable y --confirm, además de autorización del backend. Los grants, cambios de cuenta y operaciones integration:draft/activate tienen sus propios permisos y checks de versión/secuencia. No hay autorización implícita por añadir --confirm.
La CLI no puede resolver, cerrar o aprobar reportes con una transición. El feedback implementado queda a la espera de verificación humana. No la conviertas en una vía para saltarte el control de merge, migración, despliegue o ejecución.
Si hay timeout o respuesta ambigua de una escritura, consulta actividad/estado antes de decidir un reintento. Una acción nueva necesita un ID nuevo; repetir automáticamente con otro ID puede duplicar intención.
Salida y errores que requieren atención
| Resultado | Acción |
|---|---|
| JSON con sessionClosed=true | La operación terminó y el cierre de sesión fue confirmado. |
| Exit 2 / sessionClosed=false | Puede haber una operación exitosa cuyo logout no se confirmó. No repitas una escritura exitosa; revisa su estado y el cierre/expiración. |
| Exit 1 | Error de validación, transporte o permiso; lee el mensaje acotado, sin volcar credenciales. |
| 401 / 403 | Revisa identidad, grant y scope; no pruebes una contraseña de administrador al azar. |
| Argumento no soportado | Contrasta con reks --help del archivo instalado. No hay contraseña por argumento ni auto-update. |
La CLI rechaza redirecciones de autenticación, secretos de otros orígenes, archivos de credenciales no privados y opciones repetidas/contradictorias. --allow-local-http sólo permite IPs loopback explícitas para QA local; no habilita HTTP remoto.
Actualizar o retirar
Conserva versión, hash y receipt del archivo instalado. Prueba el siguiente archivo fuera de tu entorno de trabajo antes de adoptarlo. No cambies nombres de globals/env por sustitución masiva: hay aliases de compatibilidad con reglas de conflicto.
Para una instalación global, npm uninstall --global @reks/cli retira el bin. Elimina tus archivos privados de credenciales según la política local del equipo y revoca/rota la credencial si corresponde; desinstalar no demuestra que se revocó una sesión en servidor.