# Install oasdiff with Homebrew, MacPorts OpenAPI Diff and Breaking Changes. Version 1.22.0 via Homebrew; verified 2026-07-05. ## Install ```sh sudo av install brew:oasdiff ``` Additional install commands: ### macOS - Homebrew (100%): ```sh brew install oasdiff ``` Evidence: local Homebrew formula metadata - MacPorts (94%): ```sh sudo port install oasdiff ``` Evidence: MacPorts ports tree: devel/oasdiff/Portfile from https://api.github.com/repos/macports/macports-ports/git/trees/master?recursive=1 ## Package facts - **Package key:** brew:oasdiff - **Package manager:** Homebrew - **Package manager page:** - **Version:** 1.22.0 - **Source summary:** OpenAPI Diff and Breaking Changes - **Homepage:** - **Repository:** - **Upstream docs:** - **License:** Apache-2.0 - **Source archive:** - **Last updated:** 2026-07-05T23:46:05Z - **Generated:** 2026-07-08T07:18:31+00:00 ## Executables - oasdiff (cli) - oasdiff (alias) ## Build dependencies - go ## Install behavior - Post-install hook: not defined - Bottle: available on arm64_linux, arm64_sequoia, arm64_sonoma, arm64_tahoe, sonoma, x86_64_linux ## Freshness - Page generated: 2026-07-08 - Package-manager version: 1.22.0 - Package-manager updated: 2026-07-05 - Local data: ok - Upstream repository: https://github.com/oasdiff/oasdiff - Upstream latest detected: v1.22.0 (current) ## 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 - - - - - - - - ## Security Notes 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. ## 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:** - **Deprecated:** no - **Disabled:** no - **Keg Only:** no - **URL Keys:** head, stable ## Other Package-Manager Records - MacPorts - oasdiff: normalized package name match | MacPorts ports tree: devel/oasdiff/Portfile from https://api.github.com/repos/macports/macports-ports/git/trees/master?recursive=1 ## Related links - [Terminal utility packages](https://www.automicvault.com/pkg/terminal-utilities/) - Matched terminal and command-line workflow metadata. - [Text processing packages](https://www.automicvault.com/pkg/text-processing-tools/) - Matched text, document, or structured-data processing metadata. - [Developer build packages](https://www.automicvault.com/pkg/developer-build-tools/) - Matched build, compiler, generator, or developer workflow metadata. - [Networking and protocol packages](https://www.automicvault.com/pkg/networking-protocol-tools/) - Matched network, protocol, or remote-service metadata. - [go](https://www.automicvault.com/pkg/brew/go/) - Build dependency declared by Homebrew. - [fern-api](https://www.automicvault.com/pkg/brew/fern-api/) - Shares av.db curated category or tags: api, cli, developer-tools, openapi. - [algolia](https://www.automicvault.com/pkg/brew/algolia/) - Shares av.db curated category or tags: api, cli, developer-tools. - [kiota](https://www.automicvault.com/pkg/brew/kiota/) - Shares av.db curated category or tags: api, cli, developer-tools, openapi. - [prism-cli](https://www.automicvault.com/pkg/brew/prism-cli/) - Shares av.db curated category or tags: api, cli, developer-tools, openapi. - [redocly-cli](https://www.automicvault.com/pkg/brew/redocly-cli/) - Shares av.db curated category or tags: api, cli, developer-tools, openapi. - [spectral-cli](https://www.automicvault.com/pkg/brew/spectral-cli/) - Shares av.db curated category or tags: api, cli, developer-tools, openapi. - [stripe-cli](https://www.automicvault.com/pkg/brew/stripe-cli/) - Shares av.db curated category or tags: api, cli, developer-tools. - [swag](https://www.automicvault.com/pkg/brew/swag/) - Shares av.db curated category or tags: api, cli, developer-tools, openapi. - [openapi-diff](https://www.automicvault.com/pkg/brew/openapi-diff/) - Local package facts share a topical domain. Shared terms: api, breaking, breaking-changes, changes, cli. - [cargo-public-api](https://www.automicvault.com/pkg/brew/cargo-public-api/) - Local package facts share a topical domain. Shared terms: api, breaking, breaking-changes, changes, cli. ## Combined YAML source View the package source record on GitHub. [combined/oasdiff.yml](https://github.com/automic-vault/db/blob/main/combined/oasdiff.yml) ## Sources - Nucleus package database - Geiger risk classifier - package-page enrichment - curated package history - package version freshness - av.db category and tag curation - package relationship graph - external package-manager database matches - cross-ecosystem install command graph