Get started
Eight surfaces, one engine and one curated rule catalog. Pick the one that fits how you work.
Choose your path
Lint in the terminal / CI
Install the CLI and point it at your API description. Gate pull requests with the pipeline templates.
spotlight-cli → spotlight-pipeline →Lint while you edit
Lint-on-save and lint-on-type for OpenAPI, AsyncAPI, and Arazzo, right inside VS Code.
spotlight-vscode →Try it in the browser
Lint 12 artifact types against the curated catalog, filter rules by tag, fix findings with AI, and run per-artifact utilities — no install.
spotlight-validator → open ↗Govern over HTTP or with AI
Call POST /lint from any service, or expose linting to an AI client over the Model Context Protocol.
Find & manage artifacts
Search APIs.io and GitHub/GitLab/Bitbucket for API artifacts, keep provenance, and save locally or commit/PR to git.
spotlight-discovery → open ↗Author rules
The ruleset format is a standalone, versioned JSON Schema (2020-12). Browse every rule, or write your own.
spotlight-spec & the rule catalog →The whole suite
| Tool | What it is | |
|---|---|---|
| spotlight-cli | The linter engine + CLI — a maintained Spectral fork, on npm. | details |
| spotlight-spec | The standalone ruleset format + JSON Schema, and the rule catalog. | details |
| spotlight-vscode | Lint-on-save / lint-on-type in VS Code. | details |
| spotlight-validator | Browser governance workbench — lint, filter, AI-fix, utilities. | details |
| spotlight-discovery | Browser artifact registry — search, provenance, save / commit / PR. | details |
| spotlight-api | OpenAPI-first HTTP service over the engine. | details |
| spotlight-mcp | MCP server exposing linting to AI clients. | details |
| spotlight-pipeline | Governance-gate CI for GitHub / GitLab / Bitbucket / Azure / AWS. | details |
Coming from Spectral?
Spotlight is an openly-governed, progressive build of
Stoplight Spectral (Apache-2.0,
attribution preserved throughout). Your existing rulesets keep working: the
spectral: ruleset aliases and .spectral.* files are honored
alongside the spotlight: aliases and .spotlight.* files.