CLI

The sddvault command signs you in, connects your agents and manages organizations, projects and tokens.

Every command accepts --help. On failure the CLI prints error: <message> and exits with 1 (2 when the command line is wrong). When you belong to several organizations, choose one with --org, with SDD_VAULT_ORG or once with sddvault org use.

Terminal
sddvault org use acme

Global options

OptionEnvironmentWhat it does
--orgSDD_VAULT_ORGOrganization to work in, instead of the one chosen with sddvault org use.
--apiSDD_VAULT_APIAPI address instead of the organization's.
--issuerSDD_VAULT_ISSUERSign-in issuer instead of the organization's.
--client-idSDD_VAULT_CLIENT_IDClient ID used to sign in.
--mcp-urlSDD_VAULT_MCP_URLMCP server address instead of the organization's.
--no-update-check—Skip the daily check for a newer sddvault.

Sign-in and setup

CommandWhat it does
sddvault login [--device]Sign in to an organization through the browser; --device only prints the address and code.
sddvault logoutSign out and remove the stored credentials.
sddvault whoamiShow who is signed in.
sddvault init [PROJECT] [--agent <AGENTS>] [--token] [--read] [--force] [--update]Connect your coding agents in this directory to a project's MCP server and write AGENTS.md.
sddvault updateReplace sddvault with the latest release after checking it.
sddvault versionShow the versions of sddvault and of the server.
sddvault complete <SHELL> [--install]Print or install the shell completion script: zsh, bash, fish or powershell.

Organizations

CommandWhat it does
sddvault org use <SLUG>Work in this organization when no --org or SDD_VAULT_ORG is given.
sddvault org listList the organizations you are signed in to.
sddvault org members <ORG>List the members of an organization.
sddvault org invite <ORG> <EMAIL> [--language <LANGUAGE>]Invite an email address to an organization.
sddvault org invitations <ORG>List the invitations of an organization.
sddvault org resend <ORG> <ID>Send a pending invitation again.
sddvault org revoke-invite <ORG> <ID>Revoke a pending invitation.
sddvault org member set <ORG> <HANDLE> <ROLE>Set a member's organization role: owner, admin or member.
sddvault org member remove <ORG> <HANDLE>Remove a member, or leave when it is yourself.
sddvault org security show <ORG>Show the policies, single sign-on and SCIM state of an organization.
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>]Change policies: each flag takes on or off, the token lifetime takes days.
sddvault org security allowlist <ORG> [--add <ADD>] [--remove <REMOVE>] [--clear]Add or remove IP addresses and CIDR ranges of the allowlist, or clear it.

Projects

CommandWhat it does
sddvault project create <PROJECT> <NAME>Create a project: <org>/<project> and its name.
sddvault project list [ORG]List your projects, optionally in one organization.
sddvault project show <PROJECT>Show a project.
sddvault project members <PROJECT>List the members of a project.
sddvault project member set <PROJECT> <HANDLE> <ROLE>Grant a project role: owner, editor or reader.
sddvault project member remove <PROJECT> <HANDLE>Remove a project role.
sddvault project set-repo <PROJECT> <URL>Set the repository URL of a project.
sddvault project clear-repo <PROJECT>Clear the repository URL of a project.
sddvault project delete <PROJECT> --confirm <SLUG>Delete a project until it is restored or purged; --confirm takes its slug.
sddvault project restore <PROJECT>Restore a deleted project before it is purged.
sddvault project deleted <ORG>List the deleted projects of an organization that you can restore.

Agent tokens

CommandWhat it does
sddvault tokens listList your personal tokens, newest first.
sddvault tokens create <ORGANIZATION> --label <LABEL> --days <DAYS> [--read-only] [--project <PROJECT>]Create a personal token; its value is printed once.
sddvault tokens revoke <ID>Revoke one of your personal tokens.

Import and export

CommandWhat it does
sddvault import <PROJECT> <DIR> [--constitution-version <CONSTITUTION_VERSION>] [--dry-run] [--layout <LAYOUT>]Import a directory: docs/constitution.md and specs/NNN-name/*.md, or a Spec Kit or Kiro project.
sddvault export <PROJECT> [DIR] [--out <DIR>] [--spec <SPEC>] [--force]Export the current documents of a project to a directory.

Audit, usage and notifications

CommandWhat it does
sddvault audit list <ORG> [--project <PROJECT>] [--limit <LIMIT>]List the audit trail of an organization, newest first.
sddvault usage <ORG> [--period <PERIOD>] [--project <PROJECTS>] [--group <GROUP>] [--csv]MCP calls of an organization by project, agent or token.
sddvault notifications [--all]Your unread notifications, or every one with --all.
sddvault notifications read-allMark every notification read.

Billing and platform operators

CommandWhat it does
sddvault billing show <ORG>Show the plan, status, seats, projects and limits.
sddvault billing invoices <ORG> [--status <STATUSES>] [--year <YEAR>]List the invoices, optionally by status and year.
sddvault billing set-plan <ORG> <PLAN> [--interval <INTERVAL>]Move an organization to a plan (platform operators).
sddvault billing invoice issue <ORG> --month <YYYY-MM> [--status <STATUS>] [--interval <INTERVAL>]Issue the ledger invoice of a month (platform operators).
sddvault billing invoice set <ORG> <NUMBER> <STATUS>Set the status of a ledger invoice (platform operators).
sddvault ops funnel [--weeks <WEEKS>]Sign-ups, agent connections and first agent writes per week (platform operators).

import reads a directory with docs/constitution.md and specs/NNN-name/*.md, or a GitHub Spec Kit or Kiro project; --dry-run shows what would happen. export writes the current documents of a project to a directory.

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