Package Exports

sdd-cli
sdd-cli/dist/cli.js

This package does not declare an exports field, so the exports above have been automatically detected and optimized by JSPM instead. If any package subpath is missing, it is recommended to post an issue to the original package (sdd-cli) to support the "exports" field. If that is not possible, create a JSPM override to customize the exports field for this package.

Readme

sdd-cli

AI-orchestrated CLI for software delivery: it turns one product goal into requirements, specs, test plans, generated app code, quality checks, and optional GitHub publish.

What It Does

Starts from one command:
- sdd-tool "create a notes app with persistence"
Runs an end-to-end lifecycle:
- requirement draft
- functional/technical/architecture/test artifacts
- generated app in generated-app/
- quality gates and repair loop
- git init/commit
- optional GitHub publish
Works with provider CLIs (Gemini by default, Codex optional).

Why Use It

Reduces time from idea to usable baseline project.
Enforces documentation + quality gates before accepting delivery.
Keeps artifacts traceable from planning to implementation.

Install

npm install -g sdd-cli

Binary aliases:

sdd-cli
sdd
sdd-tool

Fast Start

sdd-tool "create a calculator app"

Or explicit:

sdd-cli hello "create a calculator app"

Best-Payoff Commands

sdd-cli hello "<goal>": full autopilot flow.
sdd-cli suite "<goal>": continuous mode; asks only blocking questions.
sdd-cli status --next: exact next command suggestion.
sdd-cli config show: inspect active config.
sdd-cli config set <key> <value>: set provider/model/workspace defaults.

Global Flags

--approve, --improve, --parallel
--non-interactive, --dry-run, --beginner, --from-step
--project, --output, --scope, --metrics-local
--provider, --gemini, --model

Config (Important)

Config file:

Windows: %APPDATA%/sdd-cli/config.yml
macOS/Linux: ~/.config/sdd-cli/config.yml

Default values:

workspace.default_root: {{home}}/Documents/sdd-tool-projects
ai.preferred_cli: gemini
ai.model: gemini-2.5-flash-lite
mode.default: guided
git.publish_enabled: false

Recommended first setup:

sdd-cli config init
sdd-cli config set workspace.default_root "{{home}}/Documents/sdd-tool-projects"
sdd-cli config set ai.preferred_cli gemini
sdd-cli config set git.publish_enabled false

Provider Notes

Gemini default:
- sdd-cli --provider gemini hello "<goal>"
- shortcut: sdd-cli --gemini hello "<goal>"
Auto-select available provider:
- sdd-cli --provider auto hello "<goal>"
Verify provider wiring:
- sdd-cli ai status

Output Layout

Projects are created under your workspace root:

<workspace>/<project>/requirements/...
<workspace>/<project>/generated-app/...
<workspace>/<project>/decision-log/...

Release and Docs

Changelog: docs/CHANGELOG.md
Command reference: docs/COMMANDS.md
Error code map: docs/ERROR_CODES.md
Release notes: docs/releases/
Strategy and market docs: docs/strategy/

License

MIT