vacuum
quobix.com
- Free plan
- Windows
- macOS
- Linux
- Browser extension
- API
- Self-hosted
What vacuum is
Vacuum is a free, open-source linter and quality checker for OpenAPI, AsyncAPI, and JSON Schema specifications. It accepts YAML and JSON, supporting OpenAPI 2 and 3+, AsyncAPI 3, and JSON Schema documents; AsyncAPI 2.x documents are rejected. Written in Go, it is multi-threaded and designed as both a CLI and a library for large specifications. Reports include a console dashboard, interactive HTML, and a sealed format that can be rendered again without rerunning lint logic. The HTML report runs offline without external dependencies. Vacuum accepts Spectral rulesets, with the maker describing its own ruleset as a superset. Security rules inspect API security definitions and placement. A Visual Studio Code extension detects and lints OpenAPI or AsyncAPI files, and an official GitHub Action supports CI/CD. Installation options include Homebrew, NPM, Yarn, a shell installer, Docker, and source checkout. JUnit XML output is available, with error violations creating failures by default.
Who it suits
Vacuum suits developers and API teams working with OpenAPI, AsyncAPI, or JSON Schema. It also fits CI/CD, editor-based workflows, and organizations reusing Spectral rulesets.
Good to know, and what to watch
- Supports OpenAPI, AsyncAPI, and JSON Schema
- Offline HTML reports
- Spectral ruleset compatibility
- Visual Studio Code extension
- Official GitHub Action
- AsyncAPI 2.x documents are rejected
- Company sponsorship is tied to priority support
- Many installation choices require technical setup
The verdict
Vacuum combines command-line, library, editor, and CI workflows for specification linting. Its broad report formats and ruleset compatibility are useful, while AsyncAPI support is limited to version 3.
What the maker publishes
- AsyncAPI limit
- Vacuum supports AsyncAPI 3 documents, while AsyncAPI 2.x documents are rejected. source
- CI integration
- An official GitHub Action is available for adding vacuum to GitHub CI/CD workflows. source
- CI reporting
- Vacuum can output JUnit XML, and by default only error severity violations create test failures in that output. source
- Distribution
- The maker documents installation via Homebrew, NPM, Yarn, a shell installer, Docker and source checkout. source
- 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. source
- Formats
- Vacuum accepts YAML and JSON and supports OpenAPI 2 and 3+, AsyncAPI 3 and JSON Schema documents. source
- GitHub Actions
- The official GitHub Action adds vacuum to GitHub CI/CD workflows and accepts a custom ruleset path. source
- How it runs
- Vacuum is designed as a CLI with a UI and as a library for use in other applications. source
- Implementation
- Vacuum is written in Go, is multi-threaded and is designed as both a CLI and a library. source
- Install options
- The maker documents installation through Homebrew, NPM, yarn, a shell installer, Docker, or building from source. source
- Maker
- The author page identifies the maker by the handle quobix and says the author's real name is Dave Shanley. source
- Maker identity
- The author identifies himself as Dave Shanley, uses the handle quobix and says he founded Princess Beef Heavy Industries. source
- Offline reports
- The generated HTML report has no external dependencies and runs offline. source
- Performance
- The maker says vacuum is written in Go, is multithreaded, and uses an index for complex rules. source
- Purpose
- Vacuum is a deterministic linter and quality checking tool for OpenAPI, AsyncAPI and JSON Schema specifications. source
- Purpose
- Vacuum is a deterministic linter and quality checking tool for OpenAPI, AsyncAPI, and JSON Schema specifications. source
- Reports
- Vacuum provides a console dashboard, an interactive HTML report and a sealed report that can be re-rendered without rerunning lint logic. source
- Reports
- The report command saves lint results as replayable data that can be rendered again without changing the original results. source
- Rules
- The maker says vacuum accepts Spectral rulesets and that its ruleset is a superset of Spectral’s. source
- Rulesets
- Vacuum supports Spectral rulesets, and the maker describes its ruleset as a superset of Spectral’s. source
- Scale
- The maker says vacuum is designed to lint very large specifications and work at scale. source
- Security checks
- Its security rules check whether API security definitions are correctly defined and placed. source
- 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. source
- Signed macOS release
- The maker recommends the Homebrew cask on macOS for the official release binary signed by Quobix. source
Checked against the maker's pages on 9 Oct 2026.