# Install vacuum with Homebrew, MacPorts, scoop World's fastest OpenAPI & Swagger linter. Version 0.29.9 via Homebrew; verified 2026-07-03. ## Install ```sh sudo av install brew:vacuum ``` Additional install commands: ### macOS - Homebrew (100%): ```sh brew install vacuum ``` Evidence: local Homebrew formula metadata - MacPorts (94%): ```sh sudo port install vacuum ``` Evidence: MacPorts ports tree: devel/vacuum/Portfile from https://api.github.com/repos/macports/macports-ports/git/trees/master?recursive=1 ### Windows - Scoop (92%): ```sh scoop install main/vacuum ``` Evidence: Scoop official bucket manifest trees: bucket/vacuum.json from https://api.github.com/repos/ScoopInstaller/Main/git/trees/master?recursive=1 ## Package facts - **Package key:** brew:vacuum - **Package manager:** Homebrew - **Package manager page:** - **Version:** 0.29.9 - **Source summary:** World's fastest OpenAPI & Swagger linter - **Homepage:** - **Repository:** - **Upstream docs:** - **License:** MIT - **Source archive:** - **Last updated:** 2026-07-03T00:12:23Z - **Generated:** 2026-07-08T18:08:21+00:00 ## Executables - vacuum (cli) - vacuum (alias) ## Build dependencies - go - node - yarn ## 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: 0.29.9 - Package-manager updated: 2026-07-03 - Local data: ok - Upstream repository: https://github.com/daveshanley/vacuum - Upstream latest detected: v0.29.9 (current) ## Project history and usage vacuum is a Go-based OpenAPI, AsyncAPI, and JSON Schema linter and API-quality toolkit. It was created as a fast, lightweight alternative in the same niche as Spectral while preserving compatibility with existing Spectral rulesets. ### 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 `, 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 - - - - source_facts.package-manager ## Security Notes No matching local secret-handling manifest was found for vacuum. Nucleus package metadata is still published here so future coverage has a stable package URL. ## Configuration and credential file locations These source-backed paths show where this package keeps local settings or durable credentials. Automic Vault can use them as review targets for secret scanning, migration, and command approval. ## Configuration files - Unix: ./vacuum.conf.yaml, ~/.config/vacuum.conf.yaml, ./changes-rules.yaml, ~/.config/changes-rules.yaml ## Source Database Details - **Source Database:** Homebrew formula API - **Tap:** homebrew/core - **Full Name:** vacuum - **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 - vacuum: normalized package name match | MacPorts ports tree: devel/vacuum/Portfile from https://api.github.com/repos/macports/macports-ports/git/trees/master?recursive=1 - Scoop - main/vacuum: normalized package name match | Scoop official bucket manifest trees: bucket/vacuum.json from https://api.github.com/repos/ScoopInstaller/Main/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. - [node](https://www.automicvault.com/pkg/brew/node/) - Build dependency declared by Homebrew. - [yarn](https://www.automicvault.com/pkg/brew/yarn/) - Build dependency declared by Homebrew. - [swag](https://www.automicvault.com/pkg/brew/swag/) - Shares av.db curated category or tags: api, cli, developer-tools, openapi, swagger. - [swagger-codegen](https://www.automicvault.com/pkg/brew/swagger-codegen/) - Shares av.db curated category or tags: api, cli, developer-tools, openapi, swagger. - [swagger2markup-cli](https://www.automicvault.com/pkg/brew/swagger2markup-cli/) - Shares av.db curated category or tags: api, cli, developer-tools, openapi, swagger. - [fern-api](https://www.automicvault.com/pkg/brew/fern-api/) - Shares av.db curated category or tags: api, cli, developer-tools, openapi. - [kiota](https://www.automicvault.com/pkg/brew/kiota/) - Shares av.db curated category or tags: api, cli, developer-tools, openapi. - [oasdiff](https://www.automicvault.com/pkg/brew/oasdiff/) - 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. ## Combined YAML source View the package source record on GitHub. [combined/vacuum.yml](https://github.com/automic-vault/db/blob/main/combined/vacuum.yml) ## Sources - Nucleus package database - Geiger risk classifier - package-page enrichment - curated configuration and credential file locations - 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