daveshanley/vacuum

Health v2 · maintenance only

Adoption not part of the score

1135 stars · 91 forks observed · 2026-10-11

What it is AI-extracted, prompt v1, taxonomy v1, 2026-08-30, confidence not recorded

vacuum is an ultra-fast OpenAPI, AsyncAPI, and JSON Schema linter and quality-checking tool written in Go, fully compatible with Spectral rulesets. It ships as a CLI with a dashboard UI, a Go library/SDK, a VSCode plugin, a GitHub Action, and can generate static API documentation from specs.

Use cases

• lint openapi specs in ci
• validate asyncapi contracts
• check json schema quality
• migrate from spectral to a faster linter
• enforce owasp api security rules on openapi files
• generate static api documentation from openapi
• lint large openapi specs quickly
• run api spec quality checks in github actions

When to choose

• you need Spectral-compatible linting with much better performance
• you lint thousands of OpenAPI specs at scale or in CI pipelines
• you want linting plus docs generation and editor diagnostics in one tool
• you need OWASP, OpenAPI 3.0/3.1/3.2, AsyncAPI, and JSON Schema rule coverage

When to avoid

• you depend on Spectral-specific behavior or plugins, since vacuum is not Spectral
• you need a JavaScript/TypeScript-extensible linter with custom JS rules beyond vacuum's model
• you only need simple YAML/JSON linting unrelated to API specifications

Facets

cli-tool · maturity active

linter cli documentation sdk security api-documentation apis developer-tools documentation security parsers go cli windows editor-plugin openapi asyncapi json-schema spectral-compatible swagger api-quality owasp ci-cd api-docs-generation rulesets docker macos linux nodejs

Member repositories

For agents

markdown · JSON · MCP: product_card(name="daveshanley/vacuum")