macOS
Homebrewverified · 100%
brew install oasdifflocal Homebrew formula metadata
MacPortsverified · 94%
sudo port install oasdiffMacPorts ports tree · devel/oasdiff/Portfile · source: api.github.com
brew
Install oasdiff with Homebrew, MacPorts
OpenAPI Diff and Breaking Changes. Version 1.22.0 via Homebrew; verified 2026-07-05.
install
Additional install commands
overview
Package summary
OpenAPI Diff and Breaking Changes
Project links
Commands and aliases
- oasdiff
history
Project history and usage
oasdiff is a Go command-line and library toolchain for comparing OpenAPI specifications, generating diffs and changelogs, and detecting breaking API changes. It is aimed at API teams that want contract changes to fail CI or receive review before release.
Project history
The GitHub repository was created on February 10, 2021. The project grew from a CLI that compares OpenAPI specs into a broader workflow with GitHub Actions, hosted side-by-side reviews, language-localized change messages, and support for OpenAPI 3.0 and 3.1.
Adoption history
oasdiff's adoption path is tied to CI and pull-request review rather than a runtime ecosystem. The official GitHub Action compares a pull request's OpenAPI document with the base branch, emits GitHub annotations, and can fail builds when breaking changes are detected.
How it is used
Developers run commands such as oasdiff diff, oasdiff breaking, and oasdiff changelog against two OpenAPI files or URLs. The tool supports machine-readable JSON/YAML output, human-readable text or Markdown, and HTML reports, making it suitable for both automated gates and reviewer-facing summaries.
Why package nerds care
oasdiff is significant because it packages API compatibility policy as a normal developer tool: installable by Homebrew, Go, curl, Docker, and GitHub Actions, and usable in the same CI loops that already protect tests and linting.
Timeline
- 2021-02-10: oasdiff/oasdiff repository was created.
- 2026-06-28: GitHub release v1.21.0 was published.
- The documentation describes Homebrew, curl, Docker, Go install, and prebuilt binary installation routes.
Related projects
- The oasdiff-action repository packages the CLI for GitHub Actions. The project is also tied to the OpenAPI Specification ecosystem and to the oasdiff.com review workflow for side-by-side API contract review.
Sources
- https://api.github.com/repos/oasdiff/oasdiff
- https://formulae.brew.sh/formula/oasdiff
- https://github.com/oasdiff/oasdiff
- https://github.com/oasdiff/oasdiff-action
- https://github.com/oasdiff/oasdiff/blob/main/docs/BREAKING-CHANGES.md
- https://github.com/oasdiff/oasdiff/releases
- https://www.oasdiff.com/docs/getting-started
- https://www.oasdiff.com/docs/github-action
security posture
No protected-tool coverage found yet
No matching local secret-handling manifest was found for oasdiff. Nucleus package metadata is still published here so future coverage has a stable package URL.
Install behavior
- No Homebrew post-install hook is recorded in formula metadata.
- Homebrew bottle metadata is available for 6 platform targets.
- Build metadata lists 1 build dependencies.
Recommended review
Before unattended agent use, check whether the tool reads plaintext credentials, writes remote state, publishes artifacts, or shells out to plugins.
executables
Installed executables
| Command | Kind | Exposure | Note |
|---|---|---|---|
oasdiff | cli | global executable |
freshness
Version and freshness
These signals separate page generation age, package-manager activity, and upstream release comparison. Version lag is warned only when an evidence URL and comparable versions are present.
page generated2026-07-08
manager version1.22.0
manager updated2026-07-05
local dataok
upstreamcurrent
latest detectedv1.22.0
https://github.com/oasdiff/oasdiff
- okNo freshness warnings were generated.
install metadata
Package metadata
| Package key | brew:oasdiff |
|---|---|
| Version | 1.22.0 |
| Package manager | Homebrew |
| Package manager page | https://formulae.brew.sh/formula/oasdiff |
| Homepage | https://www.oasdiff.com/ |
| Repository | https://github.com/oasdiff/oasdiff |
| Upstream docs | https://www.oasdiff.com/docs |
| License | Apache-2.0 |
| Source archive | https://github.com/oasdiff/oasdiff/archive/refs/tags/v1.22.0.tar.gz |
| Last updated | 2026-07-05T23:46:05Z |
| Pulse | updated |
| Build dependencies | go |
| Bottle | available (on arm64_linux, arm64_sequoia, arm64_sonoma, arm64_tahoe, sonoma, x86_64_linux) |
| Homebrew post-install | not defined |
| Service | none declared |
registry facts
Source database details
| Source Database | Homebrew formula API |
|---|---|
| Tap | homebrew/core |
| Full Name | oasdiff |
| Version Scheme | 0 |
| Revision | 0 |
| Head Version | HEAD |
| Bottle Stable Root URL | https://ghcr.io/v2/homebrew/core |
| Deprecated | no |
| Disabled | no |
| Keg Only | no |
| URL Keys |
|
source database matches
Other package-manager records
Matches are pulled from external package-manager indexes and kept separate from local Automic Vault package links.
MacPorts95%
oasdiff
sudo port install oasdiff- normalized package name match
- Matched by: Oasdiff
source trail
Generated from repository data
This page is generated by av-web from the private package SQLite artifact built by scripts/generate-pkg-sqlite.py.
Combined YAML source
View the package source record on GitHub.
Used sources
- Geiger risk classifier
- Nucleus package database
- av.db category and tag curation
- cross-ecosystem install command graph
- curated package history
- external package-manager database matches
- package relationship graph
- package version freshness
- package-page enrichment