# X_CLI_FLAG_UNREAD

## Means

a command declares a flag no code reads

## Typical cause

the CLI's own declarations held to each other: a `FlagSpec` the parser accepts and no file under `packages/cli/src` reads is a promise `x help` makes with nothing behind it. `x deploy --critical` said *"forces clients to reload"* and reached no reader outside the plan JSON. The four global flags are excluded — the parser owns them — and any bare `'name'` literal outside a `name:`/`short:` spec field counts as a read, so a flag echoed into `--json` still counts

## Fix

`bun test packages/cli/src/flag-reads.test.ts` — the finding names the flag and the file to read it in

[CLI and verify](/error-codes#cli-and-verify)