Docs
Using draun

Commands and Skills

Every command accepts --json for machine-readable output. Exit code is 0 on success, non-zero on error.

CommandWhat it does
draun init [--tools <ids|all>] [--language <lang>] [--force]Prepare the repo: global setup on first run, then .draun/ scaffolding and agent integrations.
draun updateRegenerate the global integration files (skills) after upgrading the CLI.
draun new <name>Scaffold a new spec folder with a slug derived from the name.
draun status [slug]Progress overview across specs; with a slug, per-issue detail.
draun issues <slug> [--ready|--blocked|--done]List a spec's issues with dependency-aware filters.
draun start <slug> <number>Mark an issue as in progress ([~]).
draun done <slug> <number>Mark an issue done ([x]) and report newly unblocked issues.
draun reopen <slug> <number>Reopen a done issue ([ ]).
draun validate <slug>Validate SPEC.md, issue files, and INDEX.md consistency.
draun instructions <spec|break|analyze> [--spec <slug>]Emit artifact-writing instructions for the AI skills.
draun archive <slug> [--force]Move a finished spec to .draun/specs/archive/.