Your AI writes code fast. The reasons disappear into chat. sdd is a local CLI that keeps short plans and notes next to your code—so you, your team, and the agent stay aligned.
sdd (Structured Vibe Coding) is a Spec-Driven Development CLI for people who use AI coding agents. It does not host process in the cloud and does not require an IDE extension. Plans, stage progress, and handoffs live as markdown in git—next to the code your agent changes.
If chat history is where your “why” dies, this tool is for you.
Install from npm: @structured-vibe-coding/cli (binary: sdd)
npm install -g @structured-vibe-coding/cli
cd your-app
sdd init --here --ai copilot # or: grok | claude | ollama
sdd new "Fix empty list crash" -w hotfix -y --no-agent
# open the intent.md path it prints → paste a few real sentences →
sdd next --no-agentFull walkthrough with a paste-ready example: Start in 10 minutes.
Learning tip
Add --no-agent the first time. You learn the process without the AI window popping up. Drop the flag later when you want the agent to help.
| I want to… | Open this |
|---|---|
| Learn sdd right now | Start in 10 minutes |
| Understand the problem it solves | Keep AI coding decisions in git |
| Understand what it is | What is sdd? |
| Build a new product from an idea | New product (greenfield) |
| Add a feature to my app | Simple feature |
| Do serious / multi-team work | Enterprise path |
| See the daily commands | Everyday loop |
| Attach org design system / AST MCP | MCP sources |
| Slice this repo’s TypeScript with AST | Code context |
| Look up a command | CLI reference |
| Need | Detail |
|---|---|
| Node.js | 20 or newer (24 is nice) |
| CLI package | @structured-vibe-coding/cli on npm |
| An AI tool | One of: GitHub Copilot, Grok, Claude Code, or Ollama |
| Time | About 10 minutes for the first loop |
| Editor | Whatever you already use |
You get a folder under changes/ with a short write-up of the work, a status that moves when you run sdd next, and a habit your AI can follow next time.
Ready for the daily rhythm? → Everyday loop