CLI

El comando sddvault inicia tu sesión, conecta tus agentes y gestiona organizaciones, proyectos y tokens.

Todos los comandos aceptan --help. Si algo falla, la CLI imprime error: <mensaje> y termina con 1 (con 2 si la línea de comandos es incorrecta). Si perteneces a varias organizaciones, elige una con --org, con SDD_VAULT_ORG o una vez con sddvault org use.

Terminal
sddvault org use acme

Opciones globales

OpciónEntornoQué hace
--orgSDD_VAULT_ORGOrganización en la que trabajar, en lugar de la elegida con sddvault org use.
--apiSDD_VAULT_APIDirección de la API en lugar de la de la organización.
--issuerSDD_VAULT_ISSUEREmisor del inicio de sesión en lugar del de la organización.
--client-idSDD_VAULT_CLIENT_IDID de cliente que se usa para iniciar sesión.
--mcp-urlSDD_VAULT_MCP_URLDirección del servidor MCP en lugar de la de la organización.
--no-update-check—Omite la comprobación diaria de una versión más reciente de sddvault.

Inicio de sesión y configuración

ComandoQué hace
sddvault login [--device]Inicia sesión en una organización desde el navegador; --device solo muestra la dirección y el código.
sddvault logoutCierra la sesión y borra las credenciales guardadas.
sddvault whoamiMuestra quién tiene la sesión iniciada.
sddvault init [PROJECT] [--agent <AGENTS>] [--token] [--read] [--force] [--update]Conecta tus agentes de código en este directorio al servidor MCP de un proyecto y escribe AGENTS.md.
sddvault updateSustituye sddvault por la última versión tras comprobarla.
sddvault versionMuestra las versiones de sddvault y del servidor.
sddvault complete <SHELL> [--install]Imprime o instala el script de autocompletado: zsh, bash, fish o powershell.

Organizaciones

ComandoQué hace
sddvault org use <SLUG>Trabaja en esta organización cuando no se indica --org ni SDD_VAULT_ORG.
sddvault org listLista las organizaciones en las que has iniciado sesión.
sddvault org members <ORG>Lista los miembros de una organización.
sddvault org invite <ORG> <EMAIL> [--language <LANGUAGE>]Invita a una dirección de correo a una organización.
sddvault org invitations <ORG>Lista las invitaciones de una organización.
sddvault org resend <ORG> <ID>Vuelve a enviar una invitación pendiente.
sddvault org revoke-invite <ORG> <ID>Revoca una invitación pendiente.
sddvault org member set <ORG> <HANDLE> <ROLE>Asigna el rol de organización de un miembro: owner, admin o member.
sddvault org member remove <ORG> <HANDLE>Quita a un miembro, o te vas tú si eres tú.
sddvault org security show <ORG>Muestra las políticas, el inicio de sesión único y el estado de SCIM de una organización.
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>]Cambia políticas: cada opción admite on u off, la duración de los tokens admite días.
sddvault org security allowlist <ORG> [--add <ADD>] [--remove <REMOVE>] [--clear]Añade o quita direcciones IP y rangos CIDR de la lista permitida, o la vacía.

Proyectos

ComandoQué hace
sddvault project create <PROJECT> <NAME>Crea un proyecto: <org>/<proyecto> y su nombre.
sddvault project list [ORG]Lista tus proyectos, opcionalmente de una organización.
sddvault project show <PROJECT>Muestra un proyecto.
sddvault project members <PROJECT>Lista los miembros de un proyecto.
sddvault project member set <PROJECT> <HANDLE> <ROLE>Concede un rol de proyecto: owner, editor o reader.
sddvault project member remove <PROJECT> <HANDLE>Quita un rol de proyecto.
sddvault project set-repo <PROJECT> <URL>Fija la URL del repositorio de un proyecto.
sddvault project clear-repo <PROJECT>Borra la URL del repositorio de un proyecto.
sddvault project delete <PROJECT> --confirm <SLUG>Elimina un proyecto hasta que se restaure o se purgue; --confirm recibe su slug.
sddvault project restore <PROJECT>Restaura un proyecto eliminado antes de que se purgue.
sddvault project deleted <ORG>Lista los proyectos eliminados de una organización que puedes restaurar.

Tokens de agente

ComandoQué hace
sddvault tokens listLista tus tokens personales, del más reciente al más antiguo.
sddvault tokens create <ORGANIZATION> --label <LABEL> --days <DAYS> [--read-only] [--project <PROJECT>]Crea un token personal; su valor se muestra una sola vez.
sddvault tokens revoke <ID>Revoca uno de tus tokens personales.

Importar y exportar

ComandoQué hace
sddvault import <PROJECT> <DIR> [--constitution-version <CONSTITUTION_VERSION>] [--dry-run] [--layout <LAYOUT>]Importa un directorio: docs/constitution.md y specs/NNN-name/*.md, o un proyecto de Spec Kit o Kiro.
sddvault export <PROJECT> [DIR] [--out <DIR>] [--spec <SPEC>] [--force]Exporta a un directorio los documentos actuales de un proyecto.

Auditoría, uso y notificaciones

ComandoQué hace
sddvault audit list <ORG> [--project <PROJECT>] [--limit <LIMIT>]Lista el registro de auditoría de una organización, del más reciente al más antiguo.
sddvault usage <ORG> [--period <PERIOD>] [--project <PROJECTS>] [--group <GROUP>] [--csv]Llamadas MCP de una organización por proyecto, agente o token.
sddvault notifications [--all]Tus notificaciones sin leer, o todas con --all.
sddvault notifications read-allMarca todas las notificaciones como leídas.

Facturación y operadores de la plataforma

ComandoQué hace
sddvault billing show <ORG>Muestra el plan, el estado, los asientos, los proyectos y los límites.
sddvault billing invoices <ORG> [--status <STATUSES>] [--year <YEAR>]Lista las facturas, opcionalmente por estado y año.
sddvault billing set-plan <ORG> <PLAN> [--interval <INTERVAL>]Pasa una organización a un plan (operadores de la plataforma).
sddvault billing invoice issue <ORG> --month <YYYY-MM> [--status <STATUS>] [--interval <INTERVAL>]Emite la factura del libro de un mes (operadores de la plataforma).
sddvault billing invoice set <ORG> <NUMBER> <STATUS>Cambia el estado de una factura del libro (operadores de la plataforma).
sddvault ops funnel [--weeks <WEEKS>]Altas, conexiones de agentes y primeras escrituras de agentes por semana (operadores de la plataforma).

import lee un directorio con docs/constitution.md y specs/NNN-name/*.md, o un proyecto de GitHub Spec Kit o Kiro; --dry-run muestra lo que ocurriría. export escribe en un directorio los documentos actuales de un proyecto.

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