| mode | Comma-separated modes: lint, validate, ci, diff, contract, docs, generate, generate-and-lint | — | ci |
| generate-root | generate mode: path to the repo to extract from | — | . |
| generate-lang | generate mode: language override (go/java/ts); auto-detected when empty | — | "" |
| generate-output | generate mode: spec output path | — | openapi.yaml |
| generate-config | generate mode: cartographer config directory | — | "" |
| generate-sourcemap | generate mode: also emit an openapi.sourcemap.json alongside output | — | false |
| go-version | Go version used to build Telescope | — | 1.25.x |
| working-directory | Workspace directory to analyze | — | . |
| paths | Space-separated file or directory paths to analyze | — | . |
| config | Optional Telescope config path | — | "" |
| ruleset | Optional ruleset path | — | "" |
| lint-engine | Lint engine: barrelman, vacuum, or both | — | barrelman |
| vacuum-ruleset | Optional vacuum-compatible ruleset path | — | "" |
| diff-base | Base ref for ci mode | — | main |
| diff-head | Head ref for ci mode | — | HEAD |
| report-scope | CI report scope: changed (graph-expanded impact) or all configured files | — | changed |
| severity | Optional minimum severity filter | — | "" |
| fail-on | Failure threshold: error or warn | — | error |
| no-external-lsp | Deprecated no-op; retained for compatibility | — | false |
| comment-pr | Post PR comment in ci mode | — | true |
| report-md | Markdown report output path | — | telescope-report.md |
| report-json | JSON report output path | — | telescope-report.json |
| report-sarif | SARIF report output path | — | "" |
| fail-on-breaking | CI/diff: exit 1 when libopenapi finds breaking API changes | — | true |
| breaking-config | Optional path to openapi-changes-style breaking rules YAML | — | "" |
| diff-left | diff mode: original spec (file path or REF:path) | — | "" |
| diff-right | diff mode: updated spec (file path or REF:path) | — | "" |
| diff-format | diff mode output format: text, json, markdown, sarif | — | json |
| diff-output | diff mode: write report to this path (under workspace) | — | telescope-breaking.json |
| contract-base-url | Base URL for contract test mode | — | "" |
| contract-spec | Spec path for contract test mode | — | "" |
| contract-wiretap | Enable wiretap proxy validation in contract mode | — | false |
| docs-output | Output directory for docs mode | — | telescope-docs |
| docs-publish | Build documentation for static hosting | — | false |