openapi-diff ☆

« Back to VersTracker

Description:
Utility for comparing two OpenAPI specifications

Type: Formula | Latest Version: 2.1.6@0 | Tracked Since: Nov 3, 2025

Links: Homepage | @OpenAPITools | formulae.brew.sh

Category: Developer tools

Tags: openapi swagger api diff developer-tools cli

Install: brew install openapi-diff

About:
openapi-diff is a command-line utility that compares two OpenAPI specifications to identify and report differences in their API definitions. It highlights changes to endpoints, parameters, responses, and other schema elements, providing a clear summary of modifications. This tool is essential for maintaining API consistency and understanding the impact of version changes.

Key Features:

Detects breaking and non-breaking changes
Supports OpenAPI 2.0 (Swagger) and 3.x formats
Outputs to console, JSON, or HTML
Validates schema consistency

Use Cases:

Verifying API changes between development and production environments
Generating changelogs for API releases
Ensuring backward compatibility during API evolution

Alternatives:

swagger-diff – Similar functionality but primarily focused on Swagger 2.0 specifications.
spectral – A highly configurable linter that can enforce rules and detect differences, though it is broader in scope.

Version History

Detected	Version	Rev	Change	Commit
Nov 3, 2025 11:18am		0	VERSION_BUMP	65eca049
Oct 8, 2024 12:10am		0	NEW	8215c32e