CLI

Il comando sddvault ti fa accedere, collega i tuoi agenti e gestisce organizzazioni, progetti e token.

Ogni comando accetta --help. In caso di errore la CLI stampa error: <messaggio> e termina con 1 (con 2 quando la riga di comando è errata). Se appartieni a più organizzazioni, scegline una con --org, con SDD_VAULT_ORG o una volta per tutte con sddvault org use.

Terminale
sddvault org use acme

Opzioni globali

OpzioneAmbienteCosa fa
--orgSDD_VAULT_ORGOrganizzazione in cui lavorare, al posto di quella scelta con sddvault org use.
--apiSDD_VAULT_APIIndirizzo dell’API al posto di quello dell’organizzazione.
--issuerSDD_VAULT_ISSUEREmittente dell’accesso al posto di quello dell’organizzazione.
--client-idSDD_VAULT_CLIENT_IDID client usato per accedere.
--mcp-urlSDD_VAULT_MCP_URLIndirizzo del server MCP al posto di quello dell’organizzazione.
--no-update-check—Salta il controllo giornaliero di una versione più recente di sddvault.

Accesso e configurazione

ComandoCosa fa
sddvault login [--device]Accedi a un’organizzazione dal browser; --device stampa solo indirizzo e codice.
sddvault logoutEsci e rimuovi le credenziali salvate.
sddvault whoamiMostra chi ha eseguito l’accesso.
sddvault init [PROJECT] [--agent <AGENTS>] [--token] [--read] [--force] [--update]Collega i tuoi agenti di codice in questa directory al server MCP di un progetto e scrive AGENTS.md.
sddvault updateSostituisce sddvault con l’ultima versione dopo averla verificata.
sddvault versionMostra le versioni di sddvault e del server.
sddvault complete <SHELL> [--install]Stampa o installa lo script di completamento: zsh, bash, fish o powershell.

Organizzazioni

ComandoCosa fa
sddvault org use <SLUG>Lavora in questa organizzazione quando non è indicato --org né SDD_VAULT_ORG.
sddvault org listElenca le organizzazioni a cui hai eseguito l’accesso.
sddvault org members <ORG>Elenca i membri di un’organizzazione.
sddvault org invite <ORG> <EMAIL> [--language <LANGUAGE>]Invita un indirizzo e-mail in un’organizzazione.
sddvault org invitations <ORG>Elenca gli inviti di un’organizzazione.
sddvault org resend <ORG> <ID>Invia di nuovo un invito in sospeso.
sddvault org revoke-invite <ORG> <ID>Revoca un invito in sospeso.
sddvault org member set <ORG> <HANDLE> <ROLE>Imposta il ruolo di organizzazione di un membro: owner, admin o member.
sddvault org member remove <ORG> <HANDLE>Rimuove un membro, oppure esci tu se sei tu.
sddvault org security show <ORG>Mostra le politiche, il single sign-on e lo stato di SCIM di un’organizzazione.
sddvault org security set <ORG> [--require-mfa <REQUIRE_MFA>] [--scim-deprovisioning <SCIM_DEPROVISIONING>] [--allow-guests <ALLOW_GUESTS>] [--admin-only-projects <ADMIN_ONLY_PROJECTS>] [--token-max-days <TOKEN_MAX_DAYS>]Modifica le politiche: ogni opzione accetta on o off, la durata dei token accetta i giorni.
sddvault org security allowlist <ORG> [--add <ADD>] [--remove <REMOVE>] [--clear]Aggiunge o rimuove indirizzi IP e intervalli CIDR dall’elenco consentito, o lo svuota.

Progetti

ComandoCosa fa
sddvault project create <PROJECT> <NAME>Crea un progetto: <org>/<progetto> e il suo nome.
sddvault project list [ORG]Elenca i tuoi progetti, facoltativamente di un’organizzazione.
sddvault project show <PROJECT>Mostra un progetto.
sddvault project members <PROJECT>Elenca i membri di un progetto.
sddvault project member set <PROJECT> <HANDLE> <ROLE>Assegna un ruolo di progetto: owner, editor o reader.
sddvault project member remove <PROJECT> <HANDLE>Rimuove un ruolo di progetto.
sddvault project set-repo <PROJECT> <URL>Imposta l’URL del repository di un progetto.
sddvault project clear-repo <PROJECT>Cancella l’URL del repository di un progetto.
sddvault project delete <PROJECT> --confirm <SLUG>Elimina un progetto finché non viene ripristinato o eliminato definitivamente; --confirm riceve il suo slug.
sddvault project restore <PROJECT>Ripristina un progetto eliminato prima dell’eliminazione definitiva.
sddvault project deleted <ORG>Elenca i progetti eliminati di un’organizzazione che puoi ripristinare.

Token degli agenti

ComandoCosa fa
sddvault tokens listElenca i tuoi token personali, dal più recente.
sddvault tokens create <ORGANIZATION> --label <LABEL> --days <DAYS> [--read-only] [--project <PROJECT>]Crea un token personale; il suo valore viene stampato una sola volta.
sddvault tokens revoke <ID>Revoca uno dei tuoi token personali.

Importazione ed esportazione

ComandoCosa fa
sddvault import <PROJECT> <DIR> [--constitution-version <CONSTITUTION_VERSION>] [--dry-run] [--layout <LAYOUT>]Importa una directory: docs/constitution.md e specs/NNN-name/*.md, oppure un progetto Spec Kit o Kiro.
sddvault export <PROJECT> [DIR] [--out <DIR>] [--spec <SPEC>] [--force]Esporta in una directory i documenti attuali di un progetto.

Audit, utilizzo e notifiche

ComandoCosa fa
sddvault audit list <ORG> [--project <PROJECT>] [--limit <LIMIT>]Elenca il registro di audit di un’organizzazione, dal più recente.
sddvault usage <ORG> [--period <PERIOD>] [--project <PROJECTS>] [--group <GROUP>] [--csv]Chiamate MCP di un’organizzazione per progetto, agente o token.
sddvault notifications [--all]Le tue notifiche non lette, o tutte con --all.
sddvault notifications read-allSegna tutte le notifiche come lette.

Fatturazione e operatori della piattaforma

ComandoCosa fa
sddvault billing show <ORG>Mostra piano, stato, posti, progetti e limiti.
sddvault billing invoices <ORG> [--status <STATUSES>] [--year <YEAR>]Elenca le fatture, facoltativamente per stato e anno.
sddvault billing set-plan <ORG> <PLAN> [--interval <INTERVAL>]Sposta un’organizzazione su un piano (operatori della piattaforma).
sddvault billing invoice issue <ORG> --month <YYYY-MM> [--status <STATUS>] [--interval <INTERVAL>]Emette la fattura del registro di un mese (operatori della piattaforma).
sddvault billing invoice set <ORG> <NUMBER> <STATUS>Imposta lo stato di una fattura del registro (operatori della piattaforma).
sddvault ops funnel [--weeks <WEEKS>]Iscrizioni, connessioni di agenti e prime scritture di agenti per settimana (operatori della piattaforma).

import legge una directory con docs/constitution.md e specs/NNN-name/*.md, oppure un progetto GitHub Spec Kit o Kiro; --dry-run mostra cosa accadrebbe. export scrive in una directory i documenti attuali di un progetto.

Terminale
sddvault import acme/payments . --dry-run sddvault export acme/payments ./out