<!-- GENERATED from cli-spec.json v0.0.0-stub — do not edit -->

Analyse a workbook and report what a conversion would do — never writes documents, never exposes cell contents.

```
rendlio diagnose <input> [options]
```

## Arguments

| Argument | Value | Required | Meaning |
|---|---|---|---|
| `<input>` | `FILE` | yes | Path to a `.xlsx` / `.xlsm` file, or `-` for stdin. |

## Options

| Option | Value | Default | Env var | Milestone | Meaning |
|---|---|---|---|---|---|
| `--report` | `PATH\|-` | — | — | M1 | Writes the [compatibility report](/docs/compat-report) JSON (`-` = stderr summary only). Without it, diagnose prints the human summary and writes no file. |
| `--culture` | `BCP-47` | `en-US` | `RENDLIO_CULTURE` | M1 | Locale for separators and month names when a number format lacks an explicit `[$-LCID]`. |

## Examples

Print the human summary; write nothing.

```bash
rendlio diagnose book.xlsx
```

Diagnose-mode reports additionally record `rendered` entries, so you see everything detected, not only the deviations. They are [safe to share](/docs/compat-report#diagnose-mode--privacy) — static text plus counts and locations, never cell contents.

```bash
rendlio diagnose book.xlsx --report diagnose.json
```

## See also

- [Global options](/docs/cli#global-options) and [environment variables](/docs/cli#environment-variables) — they apply here too
- [Exit codes](/docs/cli#exit-codes) — what `rendlio diagnose` returns and what it promises