CLI reference

Changelog

November 13, 2025

1.1.0

(feat): Add path-parameter-order, which configures how path parameters are ordered in generated code. If set to url-order (the default), path parameters are ordered in the same order as they appear in the URL. If set to spec-order, path parameters are ordered in the same order as they are listed in the spec.

Can be configured as follows in generators.yml:

1api:
2  settings:
3    path-parameter-order: url-order

1.0.2

(fix): Display OpenAPI validation warnings when using the —warnings flag with fern check. Previously, warnings were counted but not shown; now they are logged with location details when —warnings is specified.

1.0.1

(fix): Update OpenAPI operation converter to use x-fern-explorer extension instead of x-fern-explorer-enabled for setting apiPlayground property in the IR. Operations now check for the x-fern-explorer boolean value to determine API playground availability.

1.0.0

(feat): Change defaults for OpenAPI and AsyncAPI parsing settings:

  • title-as-schema-name: false (was true)
  • respect-nullable-schemas: true (was false)
  • inline-path-parameters: true (was false)
  • idiomatic-request-names: true (was false)
  • type-dates-as-strings: true (was false)
  • wrap-references-to-nullable-in-optional: false (was true)
  • coerce-optional-schemas-to-nullable: false (was true)
  • object-query-parameters: true (was false) The CLI will automatically upgrade your generators.yml to explicitly set the old defaults to preserve existing behavior. New users will get the new defaults.

0.121.2

(chore): Refactor how settings from specs are parsed and applied in the CLI.

0.121.1

(feat): Match endpoints to AI overrides examples.

0.121.0

(feat): Add batching support for AI example enhancement. The CLI now processes up to 10 endpoints at once with a single pruned OpenAPI spec, improving performance. Non-OpenAPI specs are automatically skipped.

0.120.0

(break): Rename OpenAPI extensions: x-fern-playground → x-fern-explorer and x-fern-playground-enabled → x-fern-explorer-enabled. The old extension keys are no longer recognized.