Référence des commandes CLI

Référence complète de toutes les commandes de @zeuslock/cli (v0.1.x). Pour l'installation et la première connexion, commencez par le guide de démarrage de la CLI. Chaque commande renvoyant des données accepte --json pour vos scripts, et --help fonctionne sur chaque commande et sous-commande.

Index des commandes

Identifiants et configuration

La CLI utilise volontairement deux identifiants distincts. Les identifiants utilisateur (session de connexion ou jeton d'accès CLI personnel de la page CLI du tableau de bord) pilotent les commandes de données du tableau de bord. La clé API d'organisation (zl_…, page Clés API) pilote les commandes de contenu et SIEM, qui agissent pour l'organisation.

Variables d'environnement

Le répertoire de configuration (macOS ~/Library/Application Support/zeuslock/, Windows %APPDATA%\ZeusLock\, Linux ~/.config/zeuslock/) contient auth.json (jetons de session, 0600), api-key.json (clé d'organisation) et siem-cursors.json (curseurs de tail). Les mots de passe ne sont jamais stockés et la CLI n'affiche jamais les secrets enregistrés.

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 valide la clé via GET /api/rules/sync avant de l'enregistrer ; status montre l'état configuré avec une clé masquée ; clear la supprime. La clé complète n'est jamais réaffichée.

Priorité de la clé pour les commandes machine : option --api-key → ZEUSLOCK_API_KEY → clé enregistrée.

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

Envoie le contenu à POST /api/v1/dlp/analyze sous la politique DLP active de l'organisation. Les dossiers sont parcourus récursivement (.git ignoré) et envoyés par lots de 5 fichiers. Un scan aboutissant à alert/block crée un incident réel — pas de mode simulation.

zeuslock anonymize

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

Envoie du texte UTF-8 à POST /api/v1/anonymize et renvoie le texte masqué. Texte uniquement — PDF/images/Office ne sont pas pris en charge par cet endpoint.

zeuslock hook install / run

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

install écrit .git/hooks/pre-commit (0755, --force pour remplacer un hook existant) ; run analyse les blobs indexés tels qu'ils seront commités (fichiers ajoutés/copiés/modifiés/renommés uniquement) via le même endpoint DLP et bloque le commit au seuil choisi. Les incidents du hook portent source=git_pre_commit, platform=git, method=PRE_COMMIT. install --fail-on never est refusé.

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

Les deux groupes suivent les feature gates du tableau de bord via GET /api/org : Shadow AI exige settings.shadow_ai_enabled ; MCP est actif sauf si settings.mcp_enabled vaut explicitement false. Les événements MCP sont des métadonnées assainies — jamais les prompts bruts.

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

Récupère les événements OCSF via GET /api/v1/siem/events (clé API d'organisation). pull lit une page ; tail interroge en continu et persiste son curseur dans siem-cursors.json, indexé par URL d'API, nom de curseur, catégorie et sévérité — des consommateurs distincts peuvent suivre indépendamment. Sortie JSONL par défaut, idéale pour l'ingestion 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 génère des fichiers de déploiement locaux : politiques d'installation forcée Chrome/Edge et JSON ExtensionSettings, le .reg de politique agent Windows (ServerUrl/LicenseKey sous HKLM\SOFTWARE\Policies\ZeusLock), un agent-config.json et un deployment-summary.json sans secret. Les artefacts extension exigent le plan Business/Enterprise. Priorité de la clé : --api-key → --create-key-name → --key-id → l'unique clé active déchiffrable. agent-verify vérifie l'enrôlement/heartbeat via GET /api/agents et sort en erreur si non vérifié — utile après un déploiement 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

Policy-as-code en lecture seule : get exporte l'état réel en YAML/JSON déterministe (schema_version: zeuslock.rules.v1, champs volatils retirés pour des diffs propres) ; diff compare un fichier local à l'état réel et sort avec le code 1 en cas d'écart — idéal pour un contrôle de dérive en CI. Pas d'import/apply : les politiques se modifient dans le tableau de bord.

Codes de sortie