Get started

Install SDD Vault and connect your first agent

Four steps, about three minutes. You need a terminal, a repository and an MCP-compatible agent.

Install the CLI

Run the install script in your terminal. It puts sddvault in ~/.sddvault/bin and adds it to your PATH.

Terminal
curl -fsSL https://get.sddvault.com/install.sh | sh
Or with Homebrew
Terminal
brew install eduinlight-org/tap/sddvault
Check the install
Terminal
sddvault --version
sddvault 0.2.0-build.42

Sign in

Opens your browser to sign in. If you don’t have an account yet, you can create one there.

Terminal
sddvault login
On a remote machine or over SSH, run sddvault login --device and enter the code it shows on any device.

Set up your repository

From the root of your repository, link it to a project. The CLI writes the MCP config for every agent it finds and AGENTS.md, the SDD guide your agent follows.

Terminal
cd path/to/your-repo
sddvault init your-org/your-project
✓ Signed in as you@company.com
✓ Linked this folder to your-org/your-project
✓ Wrote .mcp.json (Claude Code, VS Code)
✓ Wrote .cursor/mcp.json (Cursor)
✓ Wrote AGENTS.md
→ Open your agent and ask: "show the project status"
Replace your-org/your-project with the names shown in the web app. Run sddvault init without arguments to pick from a list.

Open your agent

Your agent now sees SDD Vault as an MCP server called sdd-vault. Open it in the repository and ask for the project status.

Ask your agent
Ask your agent
show the project status
Your agent learns the SDD workflow from SDD Vault itself: one MCP prompt per phase (specify, clarify, plan, tasks, implement and the rest), the get_agent_guide tool with this project's rules and next steps, and AGENTS.md in the repository. With --agent claude, init also writes one Claude Code skill per phase; sddvault init --update refreshes them.
  • Claude CodeRun claude in the repository.
  • CursorOpen the folder. sdd-vault appears under Settings › MCP.
  • VS CodeOpen the folder and start agent mode.
  • Other MCP agentsPoint them to .mcp.json in the repository.

Troubleshooting

Your terminal started before the installer updated PATH. Open a new terminal window, or reload your shell:

Terminal
exec $SHELL -l

No account yet?sddvault login creates one, or start from the web.
Start free