Skip to content

Global Flags

Global flags apply to all kyku commands and can be specified before or after the subcommand.

Flag Description
--verbose Resource lifecycle events (running / done / failed per change)
--debug Provider HTTP method, redacted path, status, and duration. Request/response bodies are never logged.
--parallelism <n> Limit concurrent operations (default: unlimited)
Terminal window
# Verbose logging
kyku --verbose plan
# Debug mode
kyku --debug apply
# Limit parallelism to 3 concurrent operations
kyku --parallelism 3 apply
# Combine flags
kyku --verbose --parallelism 5 plan

These flags apply to plan, apply, destroy, and related commands:

Flag Default Description
--env <name> default Environment workspace (dev, staging, prod)
--config <path> ./infrastructure.ts Config file path
--auto-approve false Skip confirmation prompt
--dry-run false Show plan without applying
--passphrase <phrase> Passphrase for encrypted state
--json false plan: print the redacted plan as JSON. Also used by output / schema.
--out <path> Save plan to a file (plan command)
--plan <path> Load plan from a file (apply command)
--force-stale-plan false Apply a saved plan even if state serial or config hash no longer match
--target <selector> plan/apply: matching resources plus ancestors. destroy: matching resources plus dependents. Selector is an exact id, an id glob (vm-*), or tags.key=value. Repeatable.
--exclude <selector> Omit matching resources (id, glob, or tags.key=value). Errors if live dependents remain.
Code Meaning
0 Success / no changes
1 General error
2 Validation error
3 Apply failed
4 Canceled by user