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 4 days ago
30 Sep 2026
Ships on a steady schedule
a new release about every 8 days
Nearly every release is documented
notes for 58 of the last 60 stable releases
Nothing withdrawn
no release was ever pulled
6 years old
777 releases · first in 2020
One column per quarter.
The root API description document is now parsed in all cases, even if it doesn't report the correct MIME type or doesn't use any of the supported file
Improved openapi-core so that it can be used within our other projects including Redoc, Reference docs, and Developer portal.
openapi-core so that it can be used within our other projects including Redoc, Reference docs, and Developer portal.Resolved an issue with the --dereferenced CLI option not functioning properly.
--dereferenced CLI option not functioning properly.Resolved an issue where transitive $refs that span multiple files would crash the validation in some cases.
Resolved a hot-reloading issue with the preview-docs command. It now automatically reloads the docs in the browser when you make live changes to an Op
preview-docs command. It now automatically reloads the docs in the browser when you make live changes to an OpenAPI description.Exported a helper function from openapi-core and implemented defaults for some functions to improve integration with the Developer portal.
openapi-core and implemented defaults for some functions to improve integration with the Developer portal.Implemented error handling for failed file uploads when using the push command. The command now displays success/failure messages in the output.
push command. The command now displays success/failure messages in the output.Source type was changed from FILE to CICD to support integration with the new CI/CD source in Workflows.
FILE to CICD to support integration with the new CI/CD source in Workflows.OpenAPI CLI now has tab completion for global installations. Run openapi completion for instructions to set it up in your environment.
openapi completion for instructions to set it up in your environment.OpenAPI CLI now has an official Docker image! You can get it from Docker Hub.
You can now use the --verbose parameter with the login command to show a detailed error trace (if any). Detailed error output is not displayed by defa
--verbose parameter with the login command to show a detailed error trace (if any). Detailed error output is not displayed by default for this command.The "access token" has been renamed to "API key" in the output of relevant OpenAPI CLI commands (login, push) to make it clearer what information the
The "access token" has been renamed to "API key" in the output of relevant OpenAPI CLI commands (login, push) to make it clearer what information the users must provide.
For improved security, the API key is now hidden (masked) when the user provides it in the terminal, and it's not logged in the user's history.
The bundle method is now able to accept Document directly in openapi-core.
bundle method is now able to accept Document directly in openapi-core.OpenAPI CLI now automatically resolves all $refs by default, even in places where they are not allowed by the specification ("incorrect $refs"). This
doNotResolveExamples to true in redocly.yaml.Fixed an issue with incorrect base directory when resolving transitive $refs.
$refs.Resolved an issue with nested filepaths that caused the push command to upload files to the wrong path when used on Windows systems.
push command to upload files to the wrong path when used on Windows systems.A new command called push is now supported by OpenAPI CLI. With this command, you can upload your API descriptions and associated files, and set up yo
push is now supported by OpenAPI CLI. With this command, you can upload your API descriptions and associated files, and set up your own CI pipeline for updating API descriptions without granting Redocly Workflows access to your repositories.. (dot) symbol in version names with the push command.Nothing published for this version
Resolved an issue with assert-node-version using the wrong path.
Resolved an issue with assert-node-version using the wrong path.
OpenAPI CLI bundles the API description before gathering stats.
Nothing published for this version
Resolved issues with tag logic and tag display names for the join command.
Resolved issues with tag logic and tag display names for the join command.
Refactored CLI command handlers.
A new command called join is now available in OpenAPI CLI. Use it to combine two or more API description files into one. The resulting file optionally
join is now available in OpenAPI CLI. Use it to combine two or more API description files into one. The resulting file optionally helps distinguish the origin of OpenAPI objects and properties by appending custom prefixes to them. Note that this command is considered experimental; meaning, it's still a work in progress.Nothing published for this version
Nothing published for this version
The previously single OpenAPI CLI package has been split into two: openapi-cli and openapi-core.
openapi-cli and openapi-core.Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Your coding agent can read these notes before it upgrades. Set up the MCP server →