CLI

O comando sddvault inicia a sua sessão, liga os seus agentes e gere organizações, projetos e tokens.

Todos os comandos aceitam --help. Em caso de falha, a CLI imprime error: <mensagem> e termina com 1 (com 2 quando a linha de comandos está errada). Se pertencer a várias organizações, escolha uma com --org, com SDD_VAULT_ORG ou uma vez com sddvault org use.

Terminal
sddvault org use acme

Opções globais

OpçãoAmbienteO que faz
--orgSDD_VAULT_ORGOrganização em que trabalhar, em vez da escolhida com sddvault org use.
--apiSDD_VAULT_APIEndereço da API em vez do da organização.
--issuerSDD_VAULT_ISSUEREmissor do início de sessão em vez do da organização.
--client-idSDD_VAULT_CLIENT_IDID de cliente usado para iniciar sessão.
--mcp-urlSDD_VAULT_MCP_URLEndereço do servidor MCP em vez do da organização.
--no-update-check—Ignora a verificação diária de uma versão mais recente do sddvault.

Início de sessão e configuração

ComandoO que faz
sddvault login [--device]Inicia sessão numa organização pelo navegador; --device só mostra o endereço e o código.
sddvault logoutTermina a sessão e remove as credenciais guardadas.
sddvault whoamiMostra quem tem sessão iniciada.
sddvault init [PROJECT] [--agent <AGENTS>] [--token] [--read] [--force] [--update]Liga os seus agentes de código nesta pasta ao servidor MCP de um projeto e escreve o AGENTS.md.
sddvault updateSubstitui o sddvault pela versão mais recente depois de a verificar.
sddvault versionMostra as versões do sddvault e do servidor.
sddvault complete <SHELL> [--install]Imprime ou instala o script de conclusão: zsh, bash, fish ou powershell.

Organizações

ComandoO que faz
sddvault org use <SLUG>Trabalha nesta organização quando não é indicado --org nem SDD_VAULT_ORG.
sddvault org listLista as organizações em que tem sessão iniciada.
sddvault org members <ORG>Lista os membros de uma organização.
sddvault org invite <ORG> <EMAIL> [--language <LANGUAGE>]Convida um endereço de e-mail para uma organização.
sddvault org invitations <ORG>Lista os convites de uma organização.
sddvault org resend <ORG> <ID>Volta a enviar um convite pendente.
sddvault org revoke-invite <ORG> <ID>Revoga um convite pendente.
sddvault org member set <ORG> <HANDLE> <ROLE>Define a função de organização de um membro: owner, admin ou member.
sddvault org member remove <ORG> <HANDLE>Remove um membro, ou sai se for você.
sddvault org security show <ORG>Mostra as políticas, o início de sessão único e o estado do SCIM de uma organização.
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>]Altera políticas: cada opção aceita on ou off, a duração dos tokens aceita dias.
sddvault org security allowlist <ORG> [--add <ADD>] [--remove <REMOVE>] [--clear]Acrescenta ou remove endereços IP e intervalos CIDR da lista permitida, ou esvazia-a.

Projetos

ComandoO que faz
sddvault project create <PROJECT> <NAME>Cria um projeto: <org>/<projeto> e o seu nome.
sddvault project list [ORG]Lista os seus projetos, opcionalmente de uma organização.
sddvault project show <PROJECT>Mostra um projeto.
sddvault project members <PROJECT>Lista os membros de um projeto.
sddvault project member set <PROJECT> <HANDLE> <ROLE>Atribui uma função de projeto: owner, editor ou reader.
sddvault project member remove <PROJECT> <HANDLE>Remove uma função de projeto.
sddvault project set-repo <PROJECT> <URL>Define o URL do repositório de um projeto.
sddvault project clear-repo <PROJECT>Limpa o URL do repositório de um projeto.
sddvault project delete <PROJECT> --confirm <SLUG>Elimina um projeto até ser restaurado ou purgado; --confirm recebe o seu slug.
sddvault project restore <PROJECT>Restaura um projeto eliminado antes de ser purgado.
sddvault project deleted <ORG>Lista os projetos eliminados de uma organização que pode restaurar.

Tokens de agente

ComandoO que faz
sddvault tokens listLista os seus tokens pessoais, do mais recente para o mais antigo.
sddvault tokens create <ORGANIZATION> --label <LABEL> --days <DAYS> [--read-only] [--project <PROJECT>]Cria um token pessoal; o seu valor é mostrado uma única vez.
sddvault tokens revoke <ID>Revoga um dos seus tokens pessoais.

Importar e exportar

ComandoO que faz
sddvault import <PROJECT> <DIR> [--constitution-version <CONSTITUTION_VERSION>] [--dry-run] [--layout <LAYOUT>]Importa uma pasta: docs/constitution.md e specs/NNN-name/*.md, ou um projeto Spec Kit ou Kiro.
sddvault export <PROJECT> [DIR] [--out <DIR>] [--spec <SPEC>] [--force]Exporta para uma pasta os documentos atuais de um projeto.

Auditoria, utilização e notificações

ComandoO que faz
sddvault audit list <ORG> [--project <PROJECT>] [--limit <LIMIT>]Lista o registo de auditoria de uma organização, do mais recente para o mais antigo.
sddvault usage <ORG> [--period <PERIOD>] [--project <PROJECTS>] [--group <GROUP>] [--csv]Chamadas MCP de uma organização por projeto, agente ou token.
sddvault notifications [--all]As suas notificações por ler, ou todas com --all.
sddvault notifications read-allMarca todas as notificações como lidas.

Faturação e operadores da plataforma

ComandoO que faz
sddvault billing show <ORG>Mostra o plano, o estado, os lugares, os projetos e os limites.
sddvault billing invoices <ORG> [--status <STATUSES>] [--year <YEAR>]Lista as faturas, opcionalmente por estado e ano.
sddvault billing set-plan <ORG> <PLAN> [--interval <INTERVAL>]Passa uma organização para um plano (operadores da plataforma).
sddvault billing invoice issue <ORG> --month <YYYY-MM> [--status <STATUS>] [--interval <INTERVAL>]Emite a fatura do registo de um mês (operadores da plataforma).
sddvault billing invoice set <ORG> <NUMBER> <STATUS>Define o estado de uma fatura do registo (operadores da plataforma).
sddvault ops funnel [--weeks <WEEKS>]Registos, ligações de agentes e primeiras escritas de agentes por semana (operadores da plataforma).

O import lê uma pasta com docs/constitution.md e specs/NNN-name/*.md, ou um projeto GitHub Spec Kit ou Kiro; --dry-run mostra o que aconteceria. O export escreve numa pasta os documentos atuais de um projeto.

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