CLI

La commande sddvault vous connecte, relie vos agents et gère les organisations, les projets et les jetons.

Toutes les commandes acceptent --help. En cas d’échec, la CLI affiche error: <message> et se termine avec 1 (2 quand la ligne de commande est incorrecte). Si vous appartenez à plusieurs organisations, choisissez-en une avec --org, avec SDD_VAULT_ORG ou une fois pour toutes avec sddvault org use.

Terminal
sddvault org use acme

Options globales

OptionEnvironnementCe qu’elle fait
--orgSDD_VAULT_ORGOrganisation dans laquelle travailler, au lieu de celle choisie avec sddvault org use.
--apiSDD_VAULT_APIAdresse de l’API au lieu de celle de l’organisation.
--issuerSDD_VAULT_ISSUERÉmetteur de connexion au lieu de celui de l’organisation.
--client-idSDD_VAULT_CLIENT_IDIdentifiant client utilisé pour se connecter.
--mcp-urlSDD_VAULT_MCP_URLAdresse du serveur MCP au lieu de celle de l’organisation.
--no-update-check—Ignore la vérification quotidienne d’une version plus récente de sddvault.

Connexion et configuration

CommandeCe qu’elle fait
sddvault login [--device]Se connecter à une organisation par le navigateur ; --device n’affiche que l’adresse et le code.
sddvault logoutSe déconnecter et supprimer les identifiants stockés.
sddvault whoamiAfficher qui est connecté.
sddvault init [PROJECT] [--agent <AGENTS>] [--token] [--read] [--force] [--update]Relier vos agents de code de ce répertoire au serveur MCP d’un projet et écrire AGENTS.md.
sddvault updateRemplacer sddvault par la dernière version après vérification.
sddvault versionAfficher les versions de sddvault et du serveur.
sddvault complete <SHELL> [--install]Afficher ou installer le script de complétion : zsh, bash, fish ou powershell.

Organisations

CommandeCe qu’elle fait
sddvault org use <SLUG>Travailler dans cette organisation quand ni --org ni SDD_VAULT_ORG ne sont donnés.
sddvault org listLister les organisations auxquelles vous êtes connecté.
sddvault org members <ORG>Lister les membres d’une organisation.
sddvault org invite <ORG> <EMAIL> [--language <LANGUAGE>]Inviter une adresse e-mail dans une organisation.
sddvault org invitations <ORG>Lister les invitations d’une organisation.
sddvault org resend <ORG> <ID>Renvoyer une invitation en attente.
sddvault org revoke-invite <ORG> <ID>Révoquer une invitation en attente.
sddvault org member set <ORG> <HANDLE> <ROLE>Définir le rôle d’organisation d’un membre : owner, admin ou member.
sddvault org member remove <ORG> <HANDLE>Retirer un membre, ou quitter l’organisation s’il s’agit de vous.
sddvault org security show <ORG>Afficher les politiques, l’authentification unique et l’état de SCIM d’une organisation.
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>]Modifier les politiques : chaque option prend on ou off, la durée des jetons prend un nombre de jours.
sddvault org security allowlist <ORG> [--add <ADD>] [--remove <REMOVE>] [--clear]Ajouter ou retirer des adresses IP et plages CIDR de la liste autorisée, ou la vider.

Projets

CommandeCe qu’elle fait
sddvault project create <PROJECT> <NAME>Créer un projet : <org>/<projet> et son nom.
sddvault project list [ORG]Lister vos projets, éventuellement ceux d’une organisation.
sddvault project show <PROJECT>Afficher un projet.
sddvault project members <PROJECT>Lister les membres d’un projet.
sddvault project member set <PROJECT> <HANDLE> <ROLE>Attribuer un rôle de projet : owner, editor ou reader.
sddvault project member remove <PROJECT> <HANDLE>Retirer un rôle de projet.
sddvault project set-repo <PROJECT> <URL>Définir l’URL du dépôt d’un projet.
sddvault project clear-repo <PROJECT>Effacer l’URL du dépôt d’un projet.
sddvault project delete <PROJECT> --confirm <SLUG>Supprimer un projet jusqu’à sa restauration ou sa purge ; --confirm prend son slug.
sddvault project restore <PROJECT>Restaurer un projet supprimé avant sa purge.
sddvault project deleted <ORG>Lister les projets supprimés d’une organisation que vous pouvez restaurer.

Jetons d’agent

CommandeCe qu’elle fait
sddvault tokens listLister vos jetons personnels, du plus récent au plus ancien.
sddvault tokens create <ORGANIZATION> --label <LABEL> --days <DAYS> [--read-only] [--project <PROJECT>]Créer un jeton personnel ; sa valeur n’est affichée qu’une fois.
sddvault tokens revoke <ID>Révoquer l’un de vos jetons personnels.

Import et export

CommandeCe qu’elle fait
sddvault import <PROJECT> <DIR> [--constitution-version <CONSTITUTION_VERSION>] [--dry-run] [--layout <LAYOUT>]Importer un répertoire : docs/constitution.md et specs/NNN-name/*.md, ou un projet Spec Kit ou Kiro.
sddvault export <PROJECT> [DIR] [--out <DIR>] [--spec <SPEC>] [--force]Exporter dans un répertoire les documents actuels d’un projet.

Audit, usage et notifications

CommandeCe qu’elle fait
sddvault audit list <ORG> [--project <PROJECT>] [--limit <LIMIT>]Lister le journal d’audit d’une organisation, du plus récent au plus ancien.
sddvault usage <ORG> [--period <PERIOD>] [--project <PROJECTS>] [--group <GROUP>] [--csv]Appels MCP d’une organisation par projet, agent ou jeton.
sddvault notifications [--all]Vos notifications non lues, ou toutes avec --all.
sddvault notifications read-allMarquer toutes les notifications comme lues.

Facturation et opérateurs de la plateforme

CommandeCe qu’elle fait
sddvault billing show <ORG>Afficher l’offre, le statut, les sièges, les projets et les limites.
sddvault billing invoices <ORG> [--status <STATUSES>] [--year <YEAR>]Lister les factures, éventuellement par statut et par année.
sddvault billing set-plan <ORG> <PLAN> [--interval <INTERVAL>]Passer une organisation à une offre (opérateurs de la plateforme).
sddvault billing invoice issue <ORG> --month <YYYY-MM> [--status <STATUS>] [--interval <INTERVAL>]Émettre la facture du registre d’un mois (opérateurs de la plateforme).
sddvault billing invoice set <ORG> <NUMBER> <STATUS>Définir le statut d’une facture du registre (opérateurs de la plateforme).
sddvault ops funnel [--weeks <WEEKS>]Inscriptions, connexions d’agents et premières écritures d’agents par semaine (opérateurs de la plateforme).

import lit un répertoire contenant docs/constitution.md et specs/NNN-name/*.md, ou un projet GitHub Spec Kit ou Kiro ; --dry-run montre ce qui se passerait. export écrit dans un répertoire les documents actuels d’un projet.

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