Reference

The reference section is the exact shape of things: how a command line is parsed, what every flag does, what each capability changes, and what the exit code means. The why lives in Concepts; this is where you look for syntax.

• CLI — the grammar (kapsl [FLAGS] TOOL [ARGS]...), every verb and flag, and how a run treats your exit codes and pipelines. CLI Reference
• Capabilities — the --cap vocabulary, what each capability concretely changes, the negations, and who is allowed to grant what. Capabilities
• Exit codes — the tool's exit code is your exit code; the shapes of kapsl's own runtime failures; what 128+n means. Exit Codes

The binary ships its own reference, kept in sync with the build:

$ kapsl -h                  # one screen: usage, verbs, escalation, topics
$ kapsl -h capabilities     # what each capability does
$ kapsl -h environments     # -e syntax and the compose model
$ kapsl -h catalogue        # tool resolution and mapping
$ kapsl -h scanning         # tiers, the y/N/d/o prompt, --skip-scan
$ kapsl -h output           # the gutter, progress, and the tool's bytes

Pages in this section

• CLI Reference The grammar, every flag and verb, verified flag-for-flag against the binary
• Capabilities The --cap vocabulary, what each one changes, the negations, and who may grant what
• Exit Codes Pass-through of the tool's code, the shapes of kapsl's own failures, and signal deaths