Skip to the content
Know your tech before you buy it. Makers: get listed from $49/mo

vacuum

quobix.com

  • Free plan
  • Windows
  • macOS
  • Linux
  • Browser extension
  • API
  • Self-hosted
7.6 Club score Visit quobix.com

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.