Referencia de comandos de la CLI

Referencia completa de todos los comandos de @zeuslock/cli (v0.1.x). Para la instalación y el primer inicio de sesión, empiece por la guía de inicio rápido de la CLI. Todos los comandos que devuelven datos aceptan --json para scripts, y --help funciona en cada comando y subcomando.

Índice de comandos

Credenciales y configuración

La CLI usa deliberadamente dos credenciales distintas. Las credenciales de usuario (sesión de inicio o token de acceso CLI personal de la página CLI del panel) manejan los comandos de datos del panel. La clave API de organización (zl_…, página Claves API) maneja los comandos de contenido y SIEM, que actúan para la organización.

Variables de entorno

El directorio de configuración (macOS ~/Library/Application Support/zeuslock/, Windows %APPDATA%\ZeusLock\, Linux ~/.config/zeuslock/) contiene auth.json (tokens de sesión, 0600), api-key.json (clave de organización) y siem-cursors.json (cursores de tail). Las contraseñas nunca se guardan y la CLI nunca imprime secretos almacenados.

zeuslock auth

zeuslock auth login --email admin@example.com
zeuslock whoami
zeuslock auth api-key set zl_your_org_api_key
zeuslock auth api-key status

auth login

auth api-key set / status / clear

set valida la clave con GET /api/rules/sync antes de guardarla; status muestra el estado con la clave enmascarada; clear la elimina. La clave completa nunca se vuelve a imprimir.

Precedencia de la clave para comandos de máquina: opción --api-key → ZEUSLOCK_API_KEY → clave guardada.

zeuslock status

zeuslock status
zeuslock status --api-key zl_your_key_here --require-license
zeuslock status --json

zeuslock scan

zeuslock scan ./secrets.txt
zeuslock scan ./src --fail-on alert
cat prompt.txt | zeuslock scan --stdin --json

Envía el contenido a POST /api/v1/dlp/analyze bajo la política DLP activa de la organización. Los directorios se recorren recursivamente (.git omitido) y se suben en lotes de 5 archivos. Un escaneo con resultado alert/block crea un incidente real — no hay simulación.

zeuslock anonymize

zeuslock anonymize customer-data.txt --output customer-data.safe.txt

Envía texto UTF-8 a POST /api/v1/anonymize y devuelve el texto enmascarado. Solo texto — PDF/imágenes/Office no son compatibles con este endpoint.

zeuslock hook install / run

zeuslock hook install --fail-on alert
zeuslock hook run --json

install escribe .git/hooks/pre-commit (0755, --force para reemplazar un hook existente); run analiza los blobs preparados tal como se confirmarán (solo archivos añadidos/copiados/modificados/renombrados) vía el mismo endpoint DLP y bloquea el commit según el umbral. Los incidentes del hook llevan source=git_pre_commit, platform=git, method=PRE_COMMIT. install --fail-on never se rechaza.

zeuslock incidents list / stats / export

zeuslock incidents list --days 7 --severity critical
zeuslock incidents stats --days 30
zeuslock incidents export --days 30 --format csv --output incidents.csv

zeuslock agents / extensions

zeuslock agents list --status offline --search linux
zeuslock agents revoke AGENT-123 --yes
zeuslock extensions status --json

zeuslock users / keys

zeuslock users list --role admin
zeuslock users remove departing@example.com --yes
zeuslock keys list --status active
zeuslock keys create --name rotation-2026-08
zeuslock keys revoke <key_id> --yes

zeuslock shadow-ai / mcp

zeuslock shadow-ai stats --days 30
zeuslock shadow-ai tools --source endpoint --status shadow
zeuslock shadow-ai users --days 7
zeuslock mcp stats
zeuslock mcp events --transport stdio --decision block --method tools/call
zeuslock mcp servers

Ambos grupos siguen los feature gates del panel vía GET /api/org: Shadow AI exige settings.shadow_ai_enabled; MCP está activo salvo que settings.mcp_enabled sea explícitamente false. Los eventos MCP son solo metadatos saneados — nunca los prompts sin procesar.

zeuslock siem pull / tail

zeuslock siem pull --api-key zl_your_key_here --severity high --limit 100
zeuslock siem tail --category dlp --interval 10 --cursor-name splunk-prod

Recupera eventos OCSF vía GET /api/v1/siem/events (clave API de organización). pull lee una página; tail sondea continuamente y persiste su cursor en siem-cursors.json, indexado por URL de API, nombre de cursor, categoría y severidad — consumidores distintos pueden seguir de forma independiente. Salida JSONL por defecto, ideal para ingestión SIEM.

zeuslock deploy gpo-config / agent-verify

zeuslock deploy gpo-config --api-key zl_your_key_here --output zeuslock-deploy
zeuslock deploy gpo-config --artifact agent --create-key-name fleet-deploy
zeuslock deploy agent-verify --hostname CLIENT01 --status online

gpo-config genera archivos de despliegue locales: políticas de instalación forzada Chrome/Edge y JSON ExtensionSettings, el .reg de política del agente Windows (ServerUrl/LicenseKey bajo HKLM\SOFTWARE\Policies\ZeusLock), un agent-config.json y un deployment-summary.json sin secretos. Los artefactos de extensión requieren el plan Business/Enterprise. Precedencia de la clave: --api-key → --create-key-name → --key-id → la única clave activa descifrable. agent-verify comprueba inscripción/heartbeat vía GET /api/agents y sale con error si no se verifica — útil tras un despliegue GPO.

zeuslock rules get / diff

zeuslock rules get --output zeuslock.rules.yaml
zeuslock rules get --scope policy --policy-id default --format json
zeuslock rules diff zeuslock.rules.yaml

Políticas como código de solo lectura: get exporta el estado real como YAML/JSON determinista (schema_version: zeuslock.rules.v1, campos volátiles eliminados para diffs limpios); diff compara un archivo local con el estado real y sale con código 1 si hay diferencias — ideal para control de deriva en CI. No hay import/apply: las políticas se cambian en el panel.

Códigos de salida