oxlint-migration-inspector
v0.1.2
Published
A visual tool to migrate incrementally from ESLint flat config to Oxlint
Readme
Oxlint Migration Inspector
A visual tool to migrate incrementally from ESLint flat config to Oxlint.
Attribution
This project is a fork of eslint config-inspector and remains distributed under the Apache-2.0 license.
What It Does
- Discovers
eslint.config.{js,mjs,cjs,ts,mts,cts}across a workspace - Computes migration coverage with three scenarios:
native(jsPlugins=false,withNursery=false,typeAware=false)default(jsPlugins=true,withNursery=false,typeAware=false)max(jsPlugins=true,withNursery=true,typeAware=true)
- Classifies ESLint rules into migration statuses (
native_default,via_js_plugins,requires_nursery,requires_type_aware,not_implemented,unsupported,off_only) - Provides command previews for incremental migration (
@oxlint/migrate+oxlint)
Usage
Run from your workspace root:
npx oxlint-migration-inspectorThen open http://localhost:7777.
Analyze from CLI (JSON/report)
npx oxlint-migration-inspector analyze --root . --json
npx oxlint-migration-inspector analyze --root . --output migration-report.jsonStatic build
npx oxlint-migration-inspector build --root .This generates a static app in .oxlint-migration-inspector.
Incremental Migration Workflow
- Keep ESLint as source of truth.
- Use
defaultcoverage as your primary KPI. - Triage
unsupportedandnot_implementedgaps first. - Use
--with-nursery/--type-awareonly where needed. - Re-run analysis and track coverage trend over time.
Development
pnpm install
pnpm dev
pnpm test
pnpm typecheck