# Install oasdiff with Homebrew, MacPorts

OpenAPI Diff and Breaking Changes. Version 1.27.0 via Homebrew; verified 2026-07-30. Also installable with macports: sudo port install oasdiff.

## 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
- **Version:** 1.27.0
- **Source summary:** OpenAPI Diff and Breaking Changes
- **Homepage:** <https://www.oasdiff.com/>
- **Repository:** <https://github.com/oasdiff/oasdiff>
- **Last updated:** 2026-07-30T21:08:37Z
- **Generated:** 2026-08-03T19:37:03+00:00

## Executables

- oasdiff (alias)

## Install behavior

- Bottle: not available

## Freshness

- Page generated: 2026-08-03
- Package-manager version: 1.27.0
## 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 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.


## 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


## Combined YAML source

View the package source record on GitHub. [combined/oasdiff.yml](https://github.com/mxcl/pkgdb/blob/main/combined/oasdiff.yml)


## Sources

- pkg.so package database
- Geiger risk classifier
- curated package history
- pkgdb category and tag curation
- external package-manager database matches
- cross-ecosystem install command graph