Choose a starter mode:
- single: one root command (cli(name).default(command)).
- multi: grouped command surface (group('...').command(...)).
Generate starter files:
- python scripts/scaffold_cli.py --name mycli --mode single --out .
- Tests are generated by default; add --no-test only when explicitly requested.
- Test template is auto-detected: Bun without Vitest uses bun:test; otherwise a Vitest template is generated.
Run and validate generated files:
- Use the printed path from the scaffolder output, for example bun ./mycli.ts --help.
- Run the generated test unless --no-test was used.
Extend behavior with references:
- references/consumer-workflow.md
- references/pattern-cookbook.md
- references/runtime-notes.md

Grounding Sources

Workflow Decision Tree

User asks for a simple one-command utility:
- Use --mode single.
User asks for nested command groups (git/gh style):
- Use --mode multi.
User asks for tests from the start:
- Do nothing; tests are scaffolded by default.
User explicitly asks for no tests:
- Add --no-test.
User asks for npm/tsx or Deno instructions:
- Keep generated code unchanged and provide runtime command alternatives from references/runtime-notes.md.

Add typed args with arg.string(), arg.number(), arg.enum(...), and arg.custom(...).
For repeated positionals, use .variadic() on an arg definition.
Add typed flags with defaults and aliases via flag.*().
Add env/config/prompt sources on each flag before action logic.
Branch on out.jsonMode for machine-readable responses.
Use runCommand() from @kjanat/dreamcli/testkit for in-process tests.
Keep output assertions explicit, including trailing newlines.

scripts/scaffold_cli.py
- Generate Bun-first starter files and optional tests.
assets/templates/*.tpl
- Source templates used by the scaffold script.
references/consumer-workflow.md
- End-to-end flow from request to validated CLI.
references/pattern-cookbook.md
- Copy-ready snippets for common DreamCLI features.
references/runtime-notes.md
- Runtime and package-manager execution guidance.

Do not modify DreamCLI core internals for consumer-app requests.
Keep generated imports on @kjanat/dreamcli and @kjanat/dreamcli/testkit.
Preserve typed resolution flow: argv -> env -> config -> prompt -> default.
Prefer Bun commands first; include npm/tsx and Deno alternatives when requested.