Global flags

Apply these flags to any capa command. Place them before or after the subcommand as Commander allows; prefer putting them next to capa for clarity.

Synopsis

capa [global-flags] <command> [args...]

Flags

Flag	Description
--json	Machine-readable CLI status and messages (not tool payload formatting)
-q, --quiet	Suppress non-essential output
-v, --verbose	Verbose output
--no-color	Disable colored output
-y, --yes	Auto-accept all confirms
--headless	Never launch a browser. Steps that would open one (capa auth OAuth, credential setup during capa install) print the URL to open manually instead

Use --headless in CI, containers, and cloud agent sandboxes, where there is no desktop browser and an attempt to open one could hang. Commands still wait for a browser flow started elsewhere to complete, for example capa auth polling for the OAuth result.

Caution

Global --json controls how capa itself reports status. For raw tool output from capa sh, use --raw, not --json.

Examples

capa --json status
capa -q install -p cursor
capa -y clean
capa --no-color -v install --no-cache
capa --headless -y install -p claude-code -e .ci.env

See also

• sh: tool execution and --raw
• install
• status