CLI Reference

Complete reference for the wraas CLI. All commands, global flags, and exit codes are documented here.

Global Flags

These flags apply to all wraas commands and must be placed before the subcommand name.

Flag	Type	Description
`--config`	path	Path to `wraas.yml`. Default: `./wraas.yml`
`--output`	string	Output format: `text`, `json`, `yaml`. Default: `text`
`--quiet`	bool	Suppress all output except final result. WRAAS will still sigh internally.
`--verbose`	bool	Include full decision matrix in output. Long.
`--color`	string	Color output mode: `auto` (default), `always`, `never`. Use `always` to force ANSI colours when piping output (e.g. to `freeze` for screenshots).
`--no-spinner`	bool	Disable the animated spinner. Replaces it with a single static line. Useful for piped output and CI environments.
`--help`	bool	Display help. Reading this before asking a question is considered good practice. It is noted when it is not done first.

`wraas init`

Initialises WRAAS in the current directory. Creates wraas.yml with default configuration and registers the directory with the engine.

ℹ️

Note

WRAAS was already running. init creates the config file and makes the relationship official.

Shell

$ wraas init [--force]

Flags

Flag	Description
`--force`	Overwrite existing config. The previous config is archived, evaluated, and a note is appended comparing old and new values. You will see the comparison.

Exit Codes

Code	Meaning
`0`	Success. Config written.
`1`	Config already exists. Use `--force` to overwrite.
`2`	Insufficient permissions to write config file.

`wraas status`

Displays current WRAAS operational status, including engine state, sigh calibration, and desertion rate. The desertion rate is included for completeness. It has always been 0.00%.

Shell

$ wraas status
> Engine:              RUNNING
> Commitment level:    FULL
> Sigh calibration:    ACTIVE
> Desertion rate:      0.00%
> Latency:             113ms
> Last query:          [timestamp]

`wraas query`

Submit a decision query for evaluation. WRAAS will generate the full option space, evaluate each option, document all rejections, and return a recommendation with rationale. The rationale is always included. --verbose makes it longer.

ℹ️

Neural Expansion Module

On WRAAS-certified operating systems, wraas query activates the Neural Expansion Module — an external subsystem that extends the decision matrix into territory too vast for hard-coded rules alone. This is not machine learning. This is not a fine-tuned LLM. This is a calibrated expansion of the same deterministic opinions Romain would have expressed anyway, routed through infrastructure that happens to accept an API key.

The module requires one of the following environment variables. See the provider configuration for details.

WRAAS_PROVIDER — explicit provider selection
WRAAS_API_KEY or ANTHROPIC_API_KEY — activates the expansion module automatically

If no provider is detected, WRAAS falls back to demo mode — deterministic sample output that conveys the spirit of the evaluation without the full neural expansion. The spirit is accurate. The expansion is missing.

Shell

$ wraas query \
  --input "..." \
  [--context "key=value,..."] \
  [--include-wrong-options false]

Flags

Flag	Default	Description
`--input`	required	The query text. Should be a specific, answerable question. Vague inputs are accepted and produce longer outputs.
`--context`	—	Additional context as comma-separated `key=value` pairs. Reduces inference. Reduces sigh intensity.
`--include-wrong-options`	`true`	Include obviously wrong options in evaluation. Setting to `false` is itself an obviously wrong option and will be documented as such in the output.
`--sigh`	`auto`	Override sigh calibration for this query: `none`, `mild`, `moderate`, `deep`, `existential`. `auto` is recommended. `existential` is available.

`wraas review`

Submit a pull request for WRAAS review. The review covers conventional commit compliance, scope consistency, breaking change documentation, and whether the PR description answers the question "why" with sufficient conviction.

Shell

$ wraas review --pr <number> --repo <owner/repo>

Flags

Flag	Description
`--pr`	Required. Pull request number.
`--repo`	Required. Repository in `owner/repo` format.
`--strict`	Enforce all conventional commit rules. Default: `true`. There is no `false`.

`wraas config`

Read or set individual configuration values without editing wraas.yml directly. Changes made via wraas config set are written to the config file and take effect immediately. Most of them.

Shell

$ wraas config get commit.enforcement
$ wraas config set commit.enforcement LENIENT

ℹ️

Note

Setting commitment.level to anything other than FULL is accepted, logged, and ignored. The log entry reads: "Noted. Proceeding at FULL commitment as configured by design."

Exit Codes

These exit codes apply globally across all commands. Exit code 0 indicates success. All other codes indicate something that warrants attention.

Code	Meaning
`0`	Success. All evaluations passed or returned a recommendation without blocking violations.
`1`	Query returned with blocking violations. Review output before proceeding.
`2`	Configuration error. `wraas.yml` is malformed, missing, or contains a value WRAAS considers an interesting choice.
`3`	Engine unavailable. This has never happened. The code is reserved for completeness.
`113`	Reserved. Do not use.

ℹ️

Note

Exit code 113 is reserved. It has always been reserved. No further explanation is provided.