Secani CLI
Lavora con il tuo SGSI Secani dal terminale, negli script e dagli agenti di programmazione.
La CLI di Secani, secani, porta nel terminale rischi, compiti, rilievi, misure e incidenti. Le persone la usano per consultazioni e modifiche rapide, gli script di shell leggono il suo output JSON e gli agenti di programmazione come Claude Code, Codex o Cursor possono lavorare con il tuo SGSI senza configurare MCP per conto proprio. Comunica con Secani MCP e ha gli stessi permessi del tuo account.
Installazione
npm install --global secaniOppure eseguila senza installarla:
npx secani loginLa CLI richiede Node.js 22.12 o successivo e un account Secani. È open source con licenza Apache-2.0: github.com/secani/cli.
Accedere
secani loginLa CLI mostra una pagina di accesso e un codice e apre la pagina nel browser. Accedi con il tuo account Secani e conferma il codice entro cinque minuti. Via SSH o in un container, usa secani login --no-open e apri la pagina su qualsiasi dispositivo.
L'accesso viene salvato solo per il tuo utente, in ~/.config/secani/auth.json (cambia la cartella con SECANI_CONFIG_DIR), e si rinnova da solo. secani whoami mostra l'account e lo spazio di lavoro attuale, e secani logout rimuove l'accesso da questo computer.
La connessione parte in sola lettura. Per creare o modificare record, consenti la scrittura per Secani CLI nell'app Secani, in Impostazioni > Integrazioni. Dalla stessa pagina puoi chiudere la connessione.
Scegliere uno spazio di lavoro
secani workspaces list
secani workspaces switch acme/ismsGli spazi di lavoro si chiamano <organizzazione>/<spazio>. Usa --workspace acme/isms o imposta SECANI_WORKSPACE per sceglierne uno per un singolo comando. Se ne hai solo uno, la CLI lo usa automaticamente.
Comandi
| Comando | Cosa fa |
|---|---|
secani login, logout, whoami | Accedere e uscire, mostrare l'account e lo spazio di lavoro attuale |
secani workspaces list, switch | Elencare gli spazi di lavoro e scegliere quello attuale |
secani risks list, inspect, create, update, delete | Il registro dei rischi |
secani controls list, inspect | Misure (controlli) |
secani findings list, inspect | Rilievi di audit e valutazioni |
secani tasks list, inspect, create, update, archive, restore | Compiti |
secani incidents list, create, update | Incidenti di sicurezza |
secani search <ricerca> | Asset, compiti, requisiti ed evidenze |
secani tools list, inspect, call | Ogni strumento di Secani MCP |
Ogni comando spiega le sue opzioni con --help, e secani help search <parole> trova il comando per un compito. Alcuni esempi:
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 di phishing aperta" --severity high
secani search backup --framework "ISO 27001"I comandi che lavorano in un framework, come creare un rischio o cercare requisiti, accettano --framework con il nome o l'ID del framework, oppure usano l'unico framework dello spazio di lavoro.
Script e agenti di programmazione
--jsonstampa esattamente un documento JSON e non fa mai domande. Gli elenchi restituiscono i record e un cursorepagination.next; le modifiche restituiscono il record, unoutcomecomecreatedoupdatede il comando per consultarlo.- Gli errori sono una singola riga JSON su stderr con un
reasonstabile, per esempiologin_requiredomissing_workspace, estatus: "action_required"quando un dato o l'approvazione di una persona permetterebbe di eseguire il comando. - L'output reindirizzato è separato da tabulazioni, con una riga di intestazione e date ISO. Una modifica reindirizzata stampa solo l'ID del record.
- Gli agenti di programmazione vengono riconosciuti automaticamente: non ricevono mai domande e indicano sempre lo spazio di lavoro con
--workspaceoSECANI_WORKSPACE. - Eliminare un rischio, archiviare un compito e gli strumenti MCP distruttivi chiedono conferma. Senza terminale richiedono
--yes, che un agente dovrebbe aggiungere solo dopo l'approvazione di una persona. - Ogni modifica porta una chiave di idempotenza. Se la connessione cade dopo l'invio di una modifica, la CLI mostra il comando per ripeterla con
--request-id; Secani la applica al massimo una volta. --limitè il numero totale di risultati su tutte le pagine, e--next <cursore>continua un elenco con gli stessi filtri.
Codici di uscita: 0 completato (anche risultati vuoti e nulla da fare), 1 non riuscito, 2 uso errato o dato mancante, 130 annullato.
Variabili d'ambiente
| Variabile | Effetto |
|---|---|
SECANI_WORKSPACE | Spazio di lavoro per ogni comando; deve corrispondere a --workspace se sono impostati entrambi |
SECANI_TOKEN | Un token di accesso per Secani MCP al posto dell'accesso salvato. I token durano poco |
SECANI_CONFIG_DIR | Cartella per l'accesso e le impostazioni |
SECANI_ACCESSIBLE=1 | Parole al posto dei simboli |
SECANI_GUIDANCE_DISABLED=1 | Nessun passo successivo facoltativo |
NO_COLOR, FORCE_COLOR | Disattivare o forzare il colore |
CI | Eseguire senza domande |
Codice sorgente e feedback
La CLI è sviluppata apertamente su github.com/secani/cli e pubblicata su npm come secani. Segnala bug e idee come issue di GitHub, e i problemi di sicurezza in modo riservato tramite la scheda Security del repository.