oasdiff/oasdiff
OpenAPI Diff and Breaking Changes observed · 2026-08-28
Health v2 · maintenance only
95/100
- Activity 99
- Release rhythm 86
- Longevity 100
Flags: no_readme
How is this computed?
round(0.45*activity + 0.35*rhythm + 0.20*longevity); archived -> min(score, 10) — computed 2026-09-03. Adoption (stars, forks) is never an input.
- gap_med: 2.0
- age_days: 2030
- days_rel: 17
- days_push: 8
- n_releases_24m: 63
Adoption not part of the score
1330 stars · 104 forks observed · 2026-08-28
What it is AI-extracted, prompt v1, taxonomy v1, 2026-08-30, confidence not recorded
oasdiff is a Go CLI tool and GitHub Action that diffs OpenAPI/Swagger specifications and detects breaking API changes, generating changelogs, side-by-side reviews, and validation reports. It integrates into CI pipelines to block merges containing unapproved breaking changes and supports OpenAPI 3.0/3.1 migration-aware comparisons.
Use cases
- detect breaking changes between two openapi specs in ci
- fail a pull request when the api contract breaks
- generate a changelog from openapi spec diffs
- migrate openapi 3.0 specs to 3.1 without false-positive diffs
- compare microservice api specs behind a gateway
- validate an openapi spec against openapi and schema rules
- share a side-by-side api spec review with teammates
When to choose
- you maintain a REST API with an OpenAPI spec and want to prevent accidental breaking changes
- you need automated API contract checks in GitHub Actions or other CI
- you want changelogs or diffs generated from OpenAPI definitions
- you're migrating specs between OpenAPI 3.0 and 3.1+
When to avoid
- you need runtime API testing or mocking rather than spec diffing
- your API has no machine-readable OpenAPI/Swagger definition
- you need GraphQL or gRPC contract diffing
Facets
cli-tool · maturity active
developer-tools api-framework ci-cd documentation apis developer-tools web-development cli windows go openapi swagger breaking-changes api-diff changelog github-actions rest-api spec-validation automation linux macos docker
8 sources
- homepage: https://www.oasdiff.com · fetched 2026-08-29 · 306e37347109
- site_page: https://www.oasdiff.com/docs/openapi-31-migration · fetched 2026-08-29 · caddb58e4860
- site_page: https://www.oasdiff.com/docs/breaking-changes · fetched 2026-08-29 · d728aeb88ce1
- site_page: https://www.oasdiff.com/docs/getting-started · fetched 2026-08-29 · 14913d5285b2
- site_page: https://www.oasdiff.com/docs/github-action · fetched 2026-08-29 · df79251a4de2
- site_page: https://www.oasdiff.com/docs/microservices · fetched 2026-08-29 · 744824640f9e
- site_page: https://www.oasdiff.com/docs · fetched 2026-08-29 · 6ccfd8a6ce11
- site_page: https://www.oasdiff.com/pricing · fetched 2026-08-29 · b3551add10c4
Member repositories
| Repository | Role | Health v2 |
|---|---|---|
| oasdiff/oasdiff | main | 95 |
For agents
Data as of 2026-08-30T08:39:29.467469+00:00 · Report a problem