opticdev/optic

OpenAPI linting, diffing and testing. Optic helps prevent breaking changes, publish accurate documentation and improve the design of your APIs.

TypeScript

1,531

3,211 commits

updated Jan 8, 2026

See the code

README

Optic - OpenAPI made easy

🧠 Generate OpenAPI from test traffic

⚡️ Keep OpenAPI spec accurate with automatic schema testing and patches

🤩 Catch Breaking Changes and apply Lint Rules with the same tool

Optic supports $ref and OpenAPI specs split across multiple files. It always

Read Documentation

Demos

https://github.com/user-attachments/assets/b386bb42-39a5-4db0-aea5-c2399588ebb0

https://github.com/user-attachments/assets/bb6af098-6e91-4636-b88c-1c9bc586cce0

https://github.com/user-attachments/assets/1b07bfd9-364c-4bbe-baeb-493bed392cdf

Install

npm install -g @useoptic/optic

⏭️ Get Started!

License

Optic is MIT Licensed

Optic Labs is now part of Atlassian

api-documentation

api-linter

apis

documentation

openapi

openapi3

swagger

Project health

Overall

3.1/10

Maintained

0/10

Code review

0/10

OpenSSF Scorecard

Significant stargazers

(top 24 of 25)

James Turnbull

1,169 followers · starred Feb 2023

Quinn Slack

980 followers · starred Oct 2020

Zanie Blue

1,112 followers · starred Apr 2023

Juan Cruz Viotti

418 followers · starred Jan 2025

Similar repos

Tufin/oasdiff

OpenAPI Diff and Breaking Changes

1,409

oasdiff/oasdiff

OpenAPI Diff and Breaking Changes

1,408

stoplightio/spectral

A flexible JSON/YAML linter for creating automated style guides, with baked in support for OpenAPI…

3,235

Redocly/redocly-cli

⚒️ Redocly CLI makes OpenAPI easy. Lint/validate to any standard, generate beautiful docs, and more.

1,521

daveshanley/vacuum

vacuum is the worlds fastest and most versatile OpenAPI, Arazzo, AsyncAPI & JSON Schema linter,…

1,136

Mermade/oas-kit

Convert Swagger 2.0 definitions to OpenAPI 3.0 and resolve/validate/lint

746

rhinobase/hono-openapi

Hono middleware to generate OpenAPI Swagger documentation

790

pb33f/openapi-changes

The world's most powerful OpenAPI breaking changes detector. Discover what changed between two…

359

opticdev/optic

OpenAPI linting, diffing and testing. Optic helps prevent breaking changes, publish accurate documentation and improve the design of your APIs.

TypeScript

1,531

3,211 commits

updated Jan 8, 2026

See the code

README

Optic - OpenAPI made easy

🧠 Generate OpenAPI from test traffic

⚡️ Keep OpenAPI spec accurate with automatic schema testing and patches

🤩 Catch Breaking Changes and apply Lint Rules with the same tool

Optic supports $ref and OpenAPI specs split across multiple files. It always

Read Documentation

Demos

https://github.com/user-attachments/assets/b386bb42-39a5-4db0-aea5-c2399588ebb0

https://github.com/user-attachments/assets/bb6af098-6e91-4636-b88c-1c9bc586cce0

https://github.com/user-attachments/assets/1b07bfd9-364c-4bbe-baeb-493bed392cdf

Install

npm install -g @useoptic/optic

⏭️ Get Started!

License

Optic is MIT Licensed

Optic Labs is now part of Atlassian

api-documentation

api-linter

apis

documentation

openapi

openapi3

swagger

Project health

Overall

3.1/10

Maintained

0/10

Code review

0/10

OpenSSF Scorecard

Significant stargazers

(top 24 of 25)

James Turnbull

1,169 followers · starred Feb 2023

Quinn Slack

980 followers · starred Oct 2020

Zanie Blue

1,112 followers · starred Apr 2023

Juan Cruz Viotti

418 followers · starred Jan 2025

Similar repos

Tufin/oasdiff

OpenAPI Diff and Breaking Changes

1,409

oasdiff/oasdiff

OpenAPI Diff and Breaking Changes

1,408

stoplightio/spectral

A flexible JSON/YAML linter for creating automated style guides, with baked in support for OpenAPI…

3,235

Redocly/redocly-cli

⚒️ Redocly CLI makes OpenAPI easy. Lint/validate to any standard, generate beautiful docs, and more.

1,521

daveshanley/vacuum

vacuum is the worlds fastest and most versatile OpenAPI, Arazzo, AsyncAPI & JSON Schema linter,…

1,136

Mermade/oas-kit

Convert Swagger 2.0 definitions to OpenAPI 3.0 and resolve/validate/lint

746

rhinobase/hono-openapi

Hono middleware to generate OpenAPI Swagger documentation

790

pb33f/openapi-changes

The world's most powerful OpenAPI breaking changes detector. Discover what changed between two…

359