0015. The CLI follows clig.dev
- Status: Accepted
- Date: 2026-11-02
Context
Until the web UI exists, the CLI is how users set up and operate stromboli, by hand and from scripts and CI.
Decision
The CLI follows the Command Line Interface Guidelines:
- Data goes to stdout and messages to stderr.
--jsonprints JSON (one event per line forinvestigate),-qsilences messages. - Exit codes:
0success,1error,2bad usage,130interrupted. - Secrets stay off the command line: a bare
tokenprompts with hidden input,token=@filereads a file,token=-reads stdin. - Destructive commands (
connector rm,actions approve,catalog import --prunewhen it deletes) ask first; without a terminal or with--no-inputthey fail unless--yesis passed. - Every command has
--helpwith examples, and shell completions are generated.
Consequences
- The same commands work interactively and in CI.
- New commands must follow these conventions.