Research: ESLint to Oxlint migration not feasible

[Copilot]

Evaluated migrating from ESLint to Oxlint. Migration is architecturally incompatible with repository requirements.

Critical Blockers

Custom plugin incompatibility: Repository uses eslint-rules/local-paths.js (~230 LOC) enforcing monorepo import path boundaries with ~ prefix conventions. Oxlint has no JavaScript plugin API—all plugins must be Rust code compiled into Oxlint itself. Cannot replicate.

Missing rules: object-shorthand (actively enforced) has no Oxlint equivalent. Advanced sorting capabilities incomplete.

Analysis

Tested Oxlint v1.34.0 (671 rules). Comparison matrix:

Feature	ESLint	Oxlint	Impact
Custom JS plugins	✅	❌	Blocker
object-shorthand	✅	❌	Blocker
Advanced import sorting	✅	⚠️	Major
TS interface sorting	✅	❌	Minor

Recommendation

Keep ESLint v9 with flat config. Current setup is modern, performant, meets all requirements.

Re-evaluate in 6-12 months if Oxlint adds plugin extensibility.

Documentation

• OXLINT_MIGRATION_RESEARCH.md - Detailed analysis (9.5KB)
• .github/OXLINT_MIGRATION_SUMMARY.md - Executive summary (2.4KB)

Warning

Firewall rules blocked me from connecting to one or more addresses (expand for details)

I tried to connect to the following addresses, but was blocked by firewall rules:

• oxc.rs
  • Triggering command: /usr/bin/curl curl -s REDACTED (dns block)

If you need me to access, download, or install something from one of these locations, you can either:

• Configure Actions setup steps to set up my environment, which run before the firewall is enabled
• Add the appropriate URLs or hosts to the custom allowlist in this repository's Copilot coding agent settings (admins only)

Original prompt

---

This section details on the original issue you should resolve

<issue_title>Migrate from ESLint to Oxlint</issue_title>
<issue_description>We want to change this repository linter from https://eslint.org/ to https://oxc.rs/docs/guide/usage/linter.html. There's a few rules in eslint.config.js, we want to make sure there's an equivalent set in place for Oxlint.</issue_description>

<agent_instructions>I'm not sure if a migration is currently possible, researching that is a part of this task!</agent_instructions>

Comments on the Issue (you are @copilot in this section)

• Fixes Migrate from ESLint to Oxlint #3126

---

💬 We'd love your input! Share your thoughts on Copilot coding agent in our 2 minute survey.

[bolt-new-by-stackblitz]

Run & review this pull request in StackBlitz Codeflow.

[vercel]

The latest updates on your projects. Learn more about Vercel for GitHub.

Project	Deployment	Review	Updated (UTC)
hey-api-docs	Ready	Preview, Comment	Dec 19, 2025 9:15pm

[changeset-bot]

⚠️ No Changeset found

Latest commit: 6cfb1ef

Merging this PR will not cause a version bump for any packages. If these changes should not result in a new version, you're good to go. If these changes should result in a version bump, you need to add a changeset.

This PR includes no changesets

When changesets are added to this PR, you'll see the packages that this PR includes changesets for and the associated semver types

Click here to learn what changesets are, and how to add one.

Click here if you're a maintainer who wants to add a changeset to this PR