Redocly/redocly-cli

Health v2 · maintenance only

Adoption not part of the score

1504 stars · 228 forks observed · 2026-08-28

What it is AI-extracted, prompt v1, taxonomy v1, 2026-08-30, confidence not recorded

Redocly CLI is an open-source command-line tool for working with OpenAPI, AsyncAPI, and Arazzo descriptions. It lints and validates API descriptions against configurable rulesets, bundles and splits multi-file specs, builds static API reference documentation with Redoc, and generates typed SDK clients.

Use cases

• lint and validate my OpenAPI spec against our API guidelines
• generate HTML API reference documentation from an OpenAPI file
• bundle a multi-file OpenAPI description into a single file
• split a large OpenAPI spec into manageable chunks
• enforce API design standards in CI/CD
• generate a TypeScript client from an OpenAPI description
• run contract tests described in Arazzo workflows
• migrate from Spectral or swagger-cli to a maintained linter

When to choose

• you need OpenAPI/AsyncAPI linting with custom rulesets and governance in CI
• you want to build static API reference docs from OpenAPI without hosting a service
• you need to bundle, split, or join OpenAPI files that use $ref across documents
• you want contract testing or drift detection based on Arazzo descriptions

When to avoid

• you need a hosted developer portal with collaboration and analytics (use Redocly's commercial platform instead)
• you only need a lightweight OpenAPI parser library to embed in your own code rather than a CLI
• you work with API formats outside OpenAPI, AsyncAPI, Arazzo, or GraphQL

Facets

cli-tool · maturity active

linter documentation cli code-review testing sdk apis developer-tools documentation cli cross-platform openapi swagger asyncapi arazzo api-linting api-docs redoc contract-testing client-generation spec-bundling api-governance command-line nodejs docker

Member repositories

For agents

markdown · JSON · MCP: product_card(name="Redocly/redocly-cli")