Secani CLI
Travaillez avec votre SMSI Secani depuis le terminal, dans des scripts et depuis des agents de code.
La CLI Secani, secani, apporte vos risques, tâches, constats, mesures et incidents dans le terminal. Les personnes l'utilisent pour des consultations et des modifications rapides, les scripts shell lisent sa sortie JSON, et les agents de code comme Claude Code, Codex ou Cursor peuvent travailler avec votre SMSI sans configurer MCP eux-mêmes. Elle communique avec Secani MCP et dispose des mêmes autorisations que votre compte.
Installer
npm install --global secaniOu lancez-la sans l'installer :
npx secani loginLa CLI nécessite Node.js 22.12 ou plus récent et un compte Secani. Elle est open source sous licence Apache-2.0 : github.com/secani/cli.
Se connecter
secani loginLa CLI affiche une page de connexion et un code, puis ouvre la page dans votre navigateur. Connectez-vous avec votre compte Secani et confirmez le code dans les cinq minutes. Via SSH ou dans un conteneur, utilisez secani login --no-open et ouvrez la page sur n'importe quel appareil.
La connexion est enregistrée uniquement pour votre utilisateur, dans ~/.config/secani/auth.json (changez le répertoire avec SECANI_CONFIG_DIR), et se renouvelle d'elle-même. secani whoami affiche le compte et l'espace de travail actuel, et secani logout supprime la connexion de cet ordinateur.
La connexion démarre en lecture seule. Pour créer ou modifier des enregistrements, autorisez l'écriture pour Secani CLI dans l'application Secani, sous Paramètres > Intégrations. La même page met fin à la connexion.
Choisir un espace de travail
secani workspaces list
secani workspaces switch acme/ismsLes espaces de travail s'écrivent <organisation>/<espace>. Passez --workspace acme/isms ou définissez SECANI_WORKSPACE pour en choisir un pour une seule commande. S'il n'y en a qu'un, la CLI l'utilise automatiquement.
Commandes
| Commande | Ce qu'elle fait |
|---|---|
secani login, logout, whoami | Se connecter et se déconnecter, afficher le compte et l'espace de travail actuel |
secani workspaces list, switch | Lister les espaces de travail et choisir l'actuel |
secani risks list, inspect, create, update, delete | Le registre des risques |
secani controls list, inspect | Mesures (contrôles) |
secani findings list, inspect | Constats d'audit et d'évaluation |
secani tasks list, inspect, create, update, archive, restore | Tâches |
secani incidents list, create, update | Incidents de sécurité |
secani search <requête> | Actifs, tâches, exigences et preuves |
secani tools list, inspect, call | Chaque outil de Secani MCP |
Chaque commande explique ses options avec --help, et secani help search <mots> trouve la commande pour une tâche. Quelques exemples :
secani tasks list --assignee me --open
secani risks list --min-level high
secani tasks update TASK-12 --status done
secani incidents create --title "E-mail de phishing ouvert" --severity high
secani search backup --framework "ISO 27001"Les commandes qui travaillent dans un framework, comme créer un risque ou rechercher des exigences, acceptent --framework avec le nom ou l'ID du framework, ou utilisent le seul framework de l'espace de travail.
Scripts et agents de code
--jsonaffiche exactement un document JSON et ne pose jamais de question. Les listes renvoient les enregistrements et un curseurpagination.next; les modifications renvoient l'enregistrement, unoutcomecommecreatedouupdatedet la commande pour le consulter.- Les erreurs sont une seule ligne JSON sur stderr avec un
reasonstable, par exemplelogin_requiredoumissing_workspace, etstatus: "action_required"lorsqu'une saisie ou l'approbation d'une personne permettrait d'exécuter la commande. - La sortie redirigée est séparée par des tabulations, avec une ligne d'en-tête et des dates ISO. Une modification redirigée n'affiche que l'ID de l'enregistrement.
- Les agents de code sont reconnus automatiquement : ils ne reçoivent jamais de question et indiquent toujours l'espace de travail avec
--workspaceouSECANI_WORKSPACE. - Supprimer un risque, archiver une tâche et les outils MCP destructifs demandent une confirmation. Sans terminal, ils exigent
--yes, qu'un agent ne doit ajouter qu'après l'approbation d'une personne. - Chaque modification porte une clé d'idempotence. Si la connexion se coupe après l'envoi d'une modification, la CLI affiche la commande pour la répéter avec
--request-id; Secani l'applique au plus une fois. --limitest le nombre total de résultats sur toutes les pages, et--next <curseur>poursuit une liste avec les mêmes filtres.
Codes de sortie : 0 terminé (y compris résultats vides et rien à faire), 1 échec, 2 utilisation incorrecte ou saisie manquante, 130 annulé.
Variables d'environnement
| Variable | Effet |
|---|---|
SECANI_WORKSPACE | Espace de travail pour chaque commande ; doit correspondre à --workspace si les deux sont définis |
SECANI_TOKEN | Un jeton d'accès pour Secani MCP à la place de la connexion enregistrée. Les jetons sont de courte durée |
SECANI_CONFIG_DIR | Répertoire de la connexion et des paramètres |
SECANI_ACCESSIBLE=1 | Des mots au lieu de symboles |
SECANI_GUIDANCE_DISABLED=1 | Pas d'étapes suivantes facultatives |
NO_COLOR, FORCE_COLOR | Désactiver ou forcer la couleur |
CI | Exécuter sans questions |
Code source et retours
La CLI est développée ouvertement sur github.com/secani/cli et publiée sur npm sous le nom secani. Signalez bugs et idées dans les issues GitHub, et les problèmes de sécurité de manière confidentielle via l'onglet Security du dépôt.