NewYour coding agent can read the release notes before it upgrades.Set up the MCP server →
npm · #3910 most downloaded on npm
See https://github.com/Redocly/redocly-cli
Last release today
17 Sep 2026
Ships on a steady schedule
a new release about every 8 days
Nearly every release is documented
notes for 60 of the last 60 stable releases
Nothing withdrawn
no release was ever pulled
6 years old
757 releases · first in 2020
One column per quarter.
Added support for basic, bearer, and apiKey security schemes in workflow generation with generate-arazzo command.
basic, bearer, and apiKey security schemes in workflow generation with generate-arazzo command.Added support for linting, preprocessors, decorators, and type extensions for Overlay v1 documents.
type keyword enum, removed null.Updated @redocly/openapi-core to v1.31.3.
Fixed sourceDescription name generation in generate-arazzo command when using OpenAPI files that contain multiple periods "." in their filenames.
sourceDescription name generation in generate-arazzo command when using OpenAPI files that contain multiple periods "." in their filenames.Added the missing respect-core import in Redocly CLI package.
respect-core import in Redocly CLI package.Added the generate-arazzo command to scaffold Arazzo description templates out of OpenAPI descriptions.
generate-arazzo command to scaffold Arazzo description templates out of OpenAPI descriptions.respect command to test APIs against Arazzo description files.Added OAuth 2.0 Device authorization flow that enables users to authenticate through Reunite API.
operation-tag-defined built-in rule to verify tags are defined on the operation prior to matching them to a global tag.Added typings and interfaces for Overlay Specification v1.0.0.
split command produced backslashes instead of forward slashes in $refs on Windows.no-invalid-media-type-examples rule crashed instead of reporting an error when it failed to resolve an example from a $ref.Fixed an issue where the build-docs command produced incorrect output.
build-docs command produced incorrect output.Fixed an issue where the build-docs command failed when React 19 was installed in the project folder.
build-docs command failed when React 19 was installed in the project folder.Updated @redocly/openapi-core to v1.28.3.
Updated @redocly/openapi-core to v1.28.2.
Updated @redocly/openapi-core to v1.28.1.
Switched to using native fetch API instead of node-fetch dependency, improving performance and reducing bundle size.
fetch API instead of node-fetch dependency, improving performance and reducing bundle size.Updated the sideNavStyle configuration schema to include the path-only option.
sideNavStyle configuration schema to include the path-only option.Fixed an issue where running the preview command failed because one of its dependencies could not be resolved. The issue occurred when Realm was not i
preview command failed because one of its dependencies could not be resolved.
The issue occurred when Realm was not installed in the node_modules of the project.Added the ability to override default problem messages for built-in rules.
apis' root in redocly.yaml was not resolved properly when the value of root was a URL.redocly build-docs to use stdout instead of stderr for simple logs.Fixed an issue where an API alias's root path might be resolved incorrectly for configuration files located outside the root folder.
Fixed an issue where the CLI would fail to run on Windows due to a breaking change in the Node.js API.
struct rule and deprecated the spec rule.
Added the spec ruleset, which enforces compliance with the specifications.join would throw an error when a glob pattern was provided.sourceDescriptions to enforce a valid type field, ensuring compliance with the Arazzo specification.Clarified usage of the --output option in the bundle command.
--output option in the bundle command.Resolved an issue where overrides for the severity of configurable rules were ignored.
Added the possibility to skip configurable rules using the --skip-rule option.
--skip-rule option.Fixed an issue where valid Redocly tokens were not recognized.
Fixed an issue with the remove-x-internal decorator where bundling API descriptions containing discriminators could fail when using Node.js v17 or ear
remove-x-internal decorator where bundling API descriptions containing discriminators could fail when using Node.js v17 or earlier.Fixed component-name-unique problems to include correct location.
component-name-unique problems to include correct location.remove-x-internal decorator, which was not removing the reference in the corresponding discriminator mapping while removing the original $ref.Updated @redocly/openapi-core to v1.25.9.
Added the REDOCLY_SUPPRESS_UPDATE_NOTICE environment variable so that users can skip version updates.
REDOCLY_SUPPRESS_UPDATE_NOTICE environment variable so that users can skip version updates.--dereferenced option. Previously, references to external files were not substituted with references to components, causing them to become invalid.externalValue as a property name was causing the API description validation process to fail.Removed the support of the x-inherit extension for Arazzo description files.
x-inherit extension for Arazzo description files.Changed the x-operation extension in Arazzo, enabling users to make requests with this extension without an API description file.
x-operation extension in Arazzo, enabling users to make requests with this extension without an API description file.x-parameters extension for Arazzo description files.Fixed an issue where the bundle command did not resolve links in externalValue.
externalValue.Added a warning message to the push and push-status commands to notify users about upcoming or ongoing resource deprecation.
push and push-status commands to notify users about upcoming or ongoing resource deprecation.Updated @redocly/openapi-core to v1.25.3.
Fixed camelCase assertion for single-letter values.
camelCase assertion for single-letter values.Added additional checks to criteria-unique Arazzo rule.
criteria-unique Arazzo rule.Added a cache for resolved plugins to ensure that plugins are only instantiated once during a single execution.
Added Respect and Arazzo rules: no-criteria-xpath, no-actions-type-end, criteria-unique.
no-criteria-xpath, no-actions-type-end, criteria-unique.Fixed a bug where bundling multiple API description files specified as CLI arguments, along with the --output option, stored the result in a single fi
--output option, stored the result in a single file instead of a folder.Added support for the output option in the per-API configuration so that the destination file can be specified in configuration.
output option in the per-API configuration so that the destination file can be specified in configuration.eject command without specifying components, which displays a selectable list of all available components.Updated @redocly/openapi-core to v1.22.1.
Updated the Arazzo validation types for workflows input, parameter objects, and criteria to match the specification.
Updated @redocly/openapi-core to v1.21.1.
Added the eject and translate commands for use with the new Reunite-hosted product family.
eject and translate commands for use with the new Reunite-hosted product family.Get more helpful error messages when there's a problem importing a plugin.
Added support for ESM plugins and importing of plugins directly from npm package: @vendor/package/plugin.js instead of ./node_modules/@vendor/package/
@vendor/package/plugin.js instead of ./node_modules/@vendor/package/plugin.js.info-license-strict rule as a replacement of the info-license-url to support the OpenAPI 3.1 changes to allow identifier or URL license details.Added support for AsyncAPI 3.0 description linting.
patternProperties incorrectly caused linting errors due to a missing PatternProperties node.Allowed the theme.openapi configuration option to accept settings specific to Redoc 2.x and earlier.
theme.openapi configuration option to accept settings specific to Redoc 2.x and earlier.spec rule where dependentSchemas was parsed as an array.
It is now correctly parsed as a map.$refs inside patternProperties.Added support for Arazzo description linting.
additionalItems from OAS 3.0.x typings. This keyword is not supported by the specification.Added JSON Schema draft 2019-09+ validation keyword - dependentRequired.
dependentRequired.Changed resolution process to include extendedTypes and plugins before linting.
contentSchema keyword to parse as a schema instance.Users can run the CLI tool behind a proxy by using HTTP_PROXY or HTTPS_PROXY environment variables to configure the proxy settings.
HTTP_PROXY or HTTPS_PROXY environment variables to configure the proxy settings.Made redocly.yaml validation consistent with the general Redocly config.
redocly.yaml validation consistent with the general Redocly config.no-invalid-media-type-examples, no-invalid-parameter-examples, and no-invalid-schema-examples rules which allowed falsy example values to pass for any schema.Added the ability to exclude some operations or entire paths from the security-defined rule.
security-defined rule.Added support for the linting command to output markdown format.
Updated @redocly/openapi-core to v1.12.2.
Updated @redocly/openapi-core to v1.12.1.
Added return values for the push and push-status commands.
push and push-status commands.Removed additional operations from the join command; use lint and/or bundle for operations such as lint and decorate.
join command; use lint and/or bundle for operations such as lint and decorate.github-actions output format for the lint command to annotate reported problems on files when used in a GitHub Actions workflow.no-invalid-media-type-examples rule externalValue example validation.Added check-config command to validate a Redocly configuration file.
check-config command to validate a Redocly configuration file.Updated license text for date and organization naming accuracy.
Fixed a problem with the preview command crashing on Windows by adding operating system detection for the correct npx executable to use.
preview command crashing on Windows by adding operating system detection for the correct npx executable to use.Your coding agent can read these notes before it upgrades. Set up the MCP server →