Install vacuum with Homebrew, MacPorts, scoop

Project links

• Homepage
• Repository
• Upstream docs
• Package manager page

Commands and aliases

• vacuum

Project history

The first GitHub release, v0.0.1, was published in May 2022 and described as an alpha but stable working release. The early changelog already included an OpenAPI rules engine, default rulesets, schema checks, a report command, Spectral report generation, and Docker packaging.

The project's README later positioned vacuum as the world's fastest OpenAPI, AsyncAPI, and JSON Schema linter, docs generator, and toolkit. Its development expanded beyond OpenAPI linting into HTML reports, a dashboard, documentation generation, overlays, OpenAPI collections, JSON Schema linting, and AsyncAPI support.

Adoption history

vacuum's adoption path is strongly package-manager oriented: the official README documents installation through a Homebrew tap, npm, yarn, curl installer, Docker images, GitHub Packages, and `go run`. The Homebrew formula, MacPorts, and Scoop entries in the input show it crossing into normal developer workstation package indexes.

The project targets CI and automated API governance workflows. The README includes a GitHub Actions installation pattern and notes token use to avoid GitHub API rate limits during automated installs.

How it is used

The common CLI path is `vacuum lint <your-openapi-spec.yaml>`, but the tool also exposes report, dashboard, HTML report, docs generation, bundle, language-server, overlay, schema, and ruleset-generation commands. The README emphasizes that it accepts YAML or JSON and supports OpenAPI 2, OpenAPI 3+, AsyncAPI 3, and JSON Schema documents.

Because vacuum is compatible with Spectral rulesets, package users can reuse existing API lint policies while benefiting from vacuum's Go binary distribution and speed-focused implementation.

Why package nerds care

vacuum matters to package nerds because it is a single native CLI that replaces a chunk of Node-oriented API linting machinery for many workflows. That makes it attractive in Homebrew, Scoop, Docker, and CI setups where fast cold starts, simple binary distribution, and reproducible lint behavior matter.

Its rapid release cadence and widening command set make it a package-manager-visible example of the OpenAPI tooling ecosystem moving from JavaScript-only linters toward compiled CLIs that still interoperate with existing ruleset formats.

Timeline

• 2022: v0.0.1 initial GitHub release published with an alpha rules engine and reporting features.
• 2022: README documents Homebrew tap, npm, yarn, curl, Docker, and Go execution paths.
• 2026: v0.28 adds JSON Schema-specific linting.
• 2026: v0.29 adds AsyncAPI 3 linting as a first-class document type.

Related projects

• Spectral is the ruleset ecosystem vacuum explicitly supports.
• OpenAPI, AsyncAPI, and JSON Schema are the specification families vacuum linting targets.
• Docker, Homebrew, npm, yarn, and Go are official installation paths documented by the project.

Sources

• https://api.github.com/repos/daveshanley/vacuum/releases/tags/v0.0.1
• https://github.com/daveshanley/vacuum
• https://quobix.com/vacuum
• source_facts.package-manager