CLI reference
spec <command> [options] — Kiro-style frontend spec workflow.
Project commands
| Command | Description |
|---|---|
spec init --stack <stack> | Initialize .specdrive/ (flutter, nextjs, react-native) |
spec doctor | Validate project setup and LLM configuration |
spec list | List all specs in the project |
Spec workflow
| Command | Description |
|---|---|
spec create <title> | Create feature spec with requirements.md |
spec create <title> --quick | Generate all docs without gates |
spec create --type bugfix | Create bugfix spec |
spec approve <gate> --spec <slug> | Approve gate: requirements, gap-analysis, design, tasks, all |
spec gap-analysis --spec <slug> | Generate gap-analysis.md (CLI free LLM) |
spec design --spec <slug> | Generate design.md from approved gap-analysis |
spec tasks --spec <slug> | Generate tasks.md from approved design |
spec status --spec <slug> | Show phase, gates, task progress |
Implementation & review
| Command | Description |
|---|---|
spec implement --spec <slug> --next | Print context for next pending task |
spec review --spec <slug> | Review implementation against design.md |
spec review --spec <slug> --ci | Exit non-zero if review fails (CI) |
Common options
| Option | Description |
|---|---|
--spec <slug> | Target spec slug (required for most commands) |
--regenerate | Overwrite existing design/tasks/gap-analysis |
--api-key <key> | One-off Gemini key for this command |
-d, --description | Feature description for create |
Environment variables
| Variable | Purpose |
|---|---|
GEMINI_API_KEY | Free tier Gemini for CLI generation (priority 1) |
GROQ_API_KEY | Groq free tier (priority 2) |
SPECDRIVE_USE_OLLAMA=1 | Use local Ollama instead of cloud keys |
SPECDRIVE_LLM_OFFLINE=1 | Template-only mode (no AI, for CI) |
Example session
spec init --stack flutter
spec create "Dark Mode Toggle"
spec approve requirements --spec dark-mode-toggle
spec gap-analysis --spec dark-mode-toggle
spec approve gap-analysis --spec dark-mode-toggle
spec design --spec dark-mode-toggle
spec approve design --spec dark-mode-toggle
spec tasks --spec dark-mode-toggle
spec approve tasks --spec dark-mode-toggle
spec implement --spec dark-mode-toggle --next