---
type: "article"
title: "Migrating from Spectral to OpenLint: we're looking for beta testers"
summary: "OpenLint 1.0.0 is on npm, the specification is published, and the docs are live. The next step is the one that matters most to anyone running Spectral today: moving over. We’re looking for beta testers to help us prove that path.\nAPI Commons has switched\nAPI Commons runs a stack of API governance tools on the linter, including validator.apicommons.org, a governance MCP server and a catalog of more than 700 rules. All of them now run on OpenLint. We checked the results against Spectral 6.16.1 on every fixture we have, and they matched.\nThe move was mostly a rename. What tripped us up is what we want to hear about from you:\nCustom functions that import Spectral’s core. A function that imports @stoplight/spectral-core won’t load in OpenLint. Import from @openlint/openlint-core instead, and use named imports rather than a default import.\nExtra metadata on rules. Rulesets that carry their own properties, such as a title or a prompt for an AI agent, are rejected, so we strip them from published rulesets for now.\nJSON output on a clean run. With -f json, a run with no problems prints [] plus a line of text, which a script parsing the output has to allow for.\nThese are in front of the community, and backwards compatibility is the subject of an open discussion.\nHow to migrate\nThe Spectral migration guide has the details. For most teams it’s two steps:\nInstall OpenLint: npm install openlint, or run it with npx openlint lint.\nChange spectral to openlint in your commands and pipelines.\nYour existing .spectral.yaml and extends: spectral:oas keep working. If you use the JavaScript API, the guide shows how to alias the old package names so you can try OpenLint without changing any code, and how to rename things properly when you’re ready.\nHelp us test it\nWe want companies, organizations, institutions and government agencies of every size to try the migration on their real rulesets and pipelines: custom functions, shared rulesets pulled over the network, CI setups, and editor workflows.\nIf you’d like to take part:\nTell us you’re testing. Email info@openlint.org or start a thread in Discussions. Just knowing who’s trying it helps us decide what to fix first.\nReport what breaks. Anything that behaves differently from Spectral, or anything the guide doesn’t cover, goes in an issue on openlint/openlint.\nCome to office hours. We meet every Thursday at 9:00 ET. Agendas are in openlint/community, and recordings and transcripts are on this site.\nWe’re aiming to make the official launch at API Days Paris, and we’d like to go in with migration stories from more than one organization. If yours could be one of them, we’d love to hear from you."
newsletter: "OpenLint Blog"
newsletter_handle: "openlint"
newsletter_url: "https://usecommune.com/n/openlint"
author: "Kin Lane (@kinlane)"
published: "2026-10-29T00:00:00.000Z"
canonical_url: "https://usecommune.com/n/openlint/a/migrating-from-spectral-to-openlint-we-re-looking-for-beta-t"
markdown_url: "https://usecommune.com/n/openlint/a/migrating-from-spectral-to-openlint-we-re-looking-for-beta-t.md"
chat_url: "https://usecommune.com/n/openlint/a/migrating-from-spectral-to-openlint-we-re-looking-for-beta-t/chat"
source_url: "https://openlint.org/blog/2026/10/29/migrating-from-spectral-beta-testers/"
body_source: "imported"
likes: 0
replies: 0
body_words: 491
---

# Migrating from Spectral to OpenLint: we're looking for beta testers

![Pill-shaped figures carrying boxes across a bridge from a dim platform to a bright one, where one figure waves the others on, under a mint-green squiggle resolving into a check mark](https://openlint.org/assets/blog/2026-10-29-migration-beta.jpg)

OpenLint 1.0.0 is on npm, the [specification](https://spec.openlint.org) is published, and the [docs](https://docs.openlint.org/getting-started/) are live. The next step is the one that matters most to anyone running Spectral today: moving over. We’re looking for beta testers to help us prove that path.

## API Commons has switched

API Commons runs a stack of API governance tools on the linter, including [validator.apicommons.org](https://validator.apicommons.org), a governance MCP server and a catalog of more than 700 rules. All of them now run on OpenLint. We checked the results against Spectral 6.16.1 on every fixture we have, and they matched.

The move was mostly a rename. What tripped us up is what we want to hear about from you:

- **Custom functions that import Spectral’s core.** A function that imports `@stoplight/spectral-core` won’t load in OpenLint. Import from `@openlint/openlint-core` instead, and use named imports rather than a default import.
- **Extra metadata on rules.** Rulesets that carry their own properties, such as a title or a prompt for an AI agent, are rejected, so we strip them from published rulesets for now.
- **JSON output on a clean run.** With `-f json`, a run with no problems prints `[]` plus a line of text, which a script parsing the output has to allow for.

These are in front of the community, and backwards compatibility is the subject of an [open discussion](https://github.com/orgs/openlint/discussions/12).

## How to migrate

The [Spectral migration guide](https://docs.openlint.org/migration-guides/spectral/) has the details. For most teams it’s two steps:

1. Install OpenLint: `npm install openlint`, or run it with `npx openlint lint`.
2. Change `spectral` to `openlint` in your commands and pipelines.

Your existing `.spectral.yaml` and `extends: spectral:oas` keep working. If you use the JavaScript API, the guide shows how to alias the old package names so you can try OpenLint without changing any code, and how to rename things properly when you’re ready.

## Help us test it

We want companies, organizations, institutions and government agencies of every size to try the migration on their real rulesets and pipelines: custom functions, shared rulesets pulled over the network, CI setups, and editor workflows.

If you’d like to take part:

- **Tell us you’re testing.** Email [info@openlint.org](mailto:info@openlint.org) or start a thread in [Discussions](https://github.com/orgs/openlint/discussions). Just knowing who’s trying it helps us decide what to fix first.
- **Report what breaks.** Anything that behaves differently from Spectral, or anything the guide doesn’t cover, goes in [an issue on openlint/openlint](https://github.com/openlint/openlint/issues).
- **Come to office hours.** We meet every Thursday at 9:00 ET. Agendas are in [openlint/community](https://github.com/openlint/community/issues?q=label%3Ameetings), and [recordings and transcripts](https://openlint.org/meetings/) are on this site.

We’re aiming to make the official launch at API Days Paris, and we’d like to go in with migration stories from more than one organization. If yours could be one of them, we’d love to hear from you.

***

## Discussion

No replies yet.
