vacuum

Spec sheet

Purpose

Vacuum is a deterministic linter and quality checking tool for OpenAPI, AsyncAPI, and JSON Schema specifications.Read 9 Oct 2026 · quobix.com

Support

The FAQ says vacuum is actively supported and that companies sponsoring the project can receive priority support for issues.Read 9 Oct 2026 · quobix.com

Maker

The author page identifies the maker by the handle quobix and says the author's real name is Dave Shanley.Read 9 Oct 2026 · quobix.com

AsyncAPI limit

Vacuum supports AsyncAPI 3 documents, while AsyncAPI 2.x documents are rejected.Read 9 Oct 2026 · quobix.com

CI integration

An official GitHub Action is available for adding vacuum to GitHub CI/CD workflows.Read 4 Oct 2026 · quobix.com

CI reporting

Vacuum can output JUnit XML, and by default only error severity violations create test failures in that output.Read 9 Oct 2026 · quobix.com

Distribution

The maker documents installation via Homebrew, NPM, Yarn, a shell installer, Docker and source checkout.Read 4 Oct 2026 · quobix.com

Editor integration

The VSCode extension is listed in the Visual Studio Code Marketplace and Open VSX, and automatically detects and lints OpenAPI or AsyncAPI YAML and JSON files.Read 4 Oct 2026 · quobix.com

Formats

Vacuum accepts YAML and JSON and supports OpenAPI 2 and 3+, AsyncAPI 3 and JSON Schema documents.Read 4 Oct 2026 · github.com

GitHub Actions

The official GitHub Action adds vacuum to GitHub CI/CD workflows and accepts a custom ruleset path.Read 9 Oct 2026 · quobix.com

How it runs

Vacuum is designed as a CLI with a UI and as a library for use in other applications.Read 9 Oct 2026 · quobix.com

Implementation

Vacuum is written in Go, is multi-threaded and is designed as both a CLI and a library.Read 4 Oct 2026 · quobix.com

Install options

The maker documents installation through Homebrew, NPM, yarn, a shell installer, Docker, or building from source.Read 9 Oct 2026 · quobix.com

Maker identity

The author identifies himself as Dave Shanley, uses the handle quobix and says he founded Princess Beef Heavy Industries.Read 4 Oct 2026 · quobix.com

Offline reports

The generated HTML report has no external dependencies and runs offline.Read 4 Oct 2026 · github.com

Performance

The maker says vacuum is written in Go, is multithreaded, and uses an index for complex rules.Read 9 Oct 2026 · quobix.com

Reports

The report command saves lint results as replayable data that can be rendered again without changing the original results.Read 9 Oct 2026 · quobix.com

Rules

The maker says vacuum accepts Spectral rulesets and that its ruleset is a superset of Spectral’s.Read 9 Oct 2026 · quobix.com

Rulesets

Vacuum supports Spectral rulesets, and the maker describes its ruleset as a superset of Spectral’s.Read 4 Oct 2026 · quobix.com

Scale

The maker says vacuum is designed to lint very large specifications and work at scale.Read 4 Oct 2026 · quobix.com

Security checks

Its security rules check whether API security definitions are correctly defined and placed.Read 4 Oct 2026 · quobix.com

Security control

The lint command exposes options to allow private or local network access for fetch requests and to allow HTTP URLs in custom JavaScript functions.Read 9 Oct 2026 · quobix.com

Signed macOS release

The maker recommends the Homebrew cask on macOS for the official release binary signed by Quobix.Read 9 Oct 2026 · quobix.com

Sponsor note

The FAQ invites sponsorship and says company sponsors can receive priority support for issues.Read 4 Oct 2026 · quobix.com

Use cases

It provides local feedback, CI output, reusable reports, editor diagnostics, and a ruleset model designed to work with existing ruleset investments.Read 9 Oct 2026 · quobix.com

VS Code

The VS Code extension is available in the Visual Studio Code Marketplace and Open VSX and automatically lints detected OpenAPI or AsyncAPI YAML and JSON files.Read 9 Oct 2026 · quobix.com

Where Specifiction places it

• API Governance Software#21 of 257.3
• API Design Tools#23 of 267.3