> This page is for Fern CLI.

> For clean Markdown content of this page, append .md to this URL. For the complete documentation index, see https://buildwithfern.com/learn/llms.txt.

## 5.7.3

**`(fix):`** Fix image path resolution on Windows for `fern docs dev` and `fern generate docs`.
Path utilities (`resolve`, `dirname`, `join`) now normalize output to forward slashes,
preventing file ID lookup mismatches caused by mixed path separators on Windows.

## 5.7.2

**`(fix):`** Allow BCP 47 locale tags (e.g. `ja-JP`, `pt-BR`, `zh-Hans-CN`) in the `translations` and `languages` fields of `docs.yml`. Previously these were rejected by the JSON-schema validator with `must be one of [en, es, fr, ...]`.

## 5.7.1

**`(fix):`** Preserve OpenAPI `default` values for array schemas across query parameters,
headers, request bodies, and response body properties so docs can render
"Defaults to ..." metadata for arrays.

## 5.7.0

**`(internal):`** cli-v2: introduce a shared stdin/stdout abstraction so commands uniformly honor
the Unix `-` marker on I/O flags (stdin for inputs, stdout for outputs), with a
"`-` used at most once per command" guard and a JSON-or-path input helper that
parses inline JSON first and falls back to a file read.

**`(internal):`** cli-v2: `fern api compile --output -` now uses the shared stdio helper (behavior
unchanged — still streams IR JSON to stdout).

**`(feat):`** cli-v2: `fern sdk generate --api -` and `fern sdk preview --api -` now read the
OpenAPI/AsyncAPI spec from stdin (e.g. `cat openapi.json | fern sdk generate --api - --org acme --target typescript --output ./sdk`).

**`(feat):`** cli-v2: `fern api split --output -` prints the generated overlay/overrides for
the matching spec to stdout as a preview, without modifying the workspace
(no git-HEAD restore, no fern.yml updates). Requires `--api` to select a single
spec.

## 5.6.1

**`(fix):`** Fix translated docs pages failing to resolve shared snippets (`<Markdown src="..."/>` and `<Code src="..."/>`).
Snippet references are now resolved before registering translations, with locale-aware loading that prefers
translated snippets (e.g., `translations/zh/snippets/foo.mdx`) when available.

## 5.6.0

**`(feat):`** Add `fern automations upgrade` command that wraps `fern upgrade` and
`fern generator upgrade` into a single invocation with structured JSON
output (`--json`). Designed for consumption by the fern-upgrade GitHub
Action.

**`(fix):`** Replace brittle hardcoded changelog URL map in `upgradeGenerator.ts` with
a regex-based derivation that supports all current and future generators.