# eslint-plugin-oxlint

> Turn off all rules already supported by oxlint

Latest version **1.86.0** (published 2026-09-28) · MIT license · 0 weekly downloads

## Install

```sh
npm install eslint-plugin-oxlint
pnpm add eslint-plugin-oxlint
yarn add eslint-plugin-oxlint
bun add eslint-plugin-oxlint
```

## Health

**Score 75/100 (B)** — status: active.

Positive: has types; esm support; no vulnerabilities; has provenance; recently updated; high maintenance score; high quality score.

Warnings: low downloads.

## Facts

| | |
|---|---|
| Version | 1.86.0 |
| Published | 2026-09-28 |
| First published | 2023-12-28 |
| Weekly downloads | 0 |
| License | MIT |
| TypeScript types | bundled |
| Module format | ESM |
| Dependencies | 1 |
| Unpacked size | 303.4 KB |
| Known vulnerabilities | 0 |
| Install scripts | no |
| Provenance | attested (GitHub Actions) |
| GitHub stars | 457 |
| Author | Dunqing <dengqing0821@gmail.com> |
| Maintainers | boshen, dengqing |
| Keywords | eslint, oxc, oxlint, rules |

## Links

- npm: https://www.npmjs.com/package/eslint-plugin-oxlint
- Repository: https://github.com/oxc-project/eslint-plugin-oxlint
- npm.io page: https://npm.io/package/eslint-plugin-oxlint

## Dependencies (1)

- [jsonc-parser](https://npm.io/package/jsonc-parser.md) ^3.3.1

## Alternatives

- [eslint-plugin-sonarjs](https://npm.io/package/eslint-plugin-sonarjs.md) — 2.9M weekly downloads
- [eslint-config-expo](https://npm.io/package/eslint-config-expo.md) — 1.5M weekly downloads
- [@matter/protocol](https://npm.io/package/@matter/protocol.md) — 63.5K weekly downloads
- [@eventcatalog/linter](https://npm.io/package/@eventcatalog/linter.md) — 24.8K weekly downloads
- [@inrupt/eslint-config-base](https://npm.io/package/@inrupt/eslint-config-base.md) — 4.5K weekly downloads

## Recent versions

- 1.86.0 (latest) — 2026-09-28
- 1.85.0 — 2026-09-22
- 1.84.0 — 2026-09-21
- 1.83.0 — 2026-09-14
- 1.82.0 — 2026-09-07
- 1.81.0 — 2026-09-01
- 1.80.0 — 2026-08-24
- 1.79.0 — 2026-08-18
- 1.78.0 — 2026-08-10
- 1.77.0 — 2026-08-03
- 1.76.0 — 2026-07-27
- 1.75.0 — 2026-07-22
- 1.73.0 — 2026-07-07
- 1.72.0 — 2026-06-30
- 1.71.0 — 2026-06-22
- … 138 more at https://npm.io/package/eslint-plugin-oxlint/versions

## README

# eslint-plugin-oxlint

![GitHub Actions Workflow Status](https://img.shields.io/github/actions/workflow/status/oxc-project/eslint-plugin-oxlint/.github%2Fworkflows%2Ftest.yml?branch=main)
![NPM Version](https://img.shields.io/npm/v/eslint-plugin-oxlint) ![NPM Downloads](https://img.shields.io/npm/dm/eslint-plugin-oxlint)

Turn off all rules already supported by [`oxlint`](https://oxc.rs/docs/guide/usage/linter). The rules are extracted from [here](https://github.com/oxc-project/oxc/blob/main/crates/oxc_linter/src/rules.rs).

## Installation

```shell
pnpm add -D eslint-plugin-oxlint
```

## Usage

### Run oxlint before eslint

Add the following script to your `package.json`:

```json
{
  "scripts": {
    "lint": "oxlint && eslint"
  }
}
```

### Flat config

This plugin is optimized for flat config usage (eslint >= 9.0). See [here](https://eslint.org/docs/latest/use/configure/configuration-files-new) for more details.

Example:

```js
// eslint.config.js
import oxlint from 'eslint-plugin-oxlint';
export default [
  ...// other plugins
  ...oxlint.configs['flat/recommended'], // oxlint should be the last one
];
```

### Legacy config

If you are using legacy configuration (eslint < 9.0), you can use the following config:

```js
// .eslintrc.js
module.exports = {
  ... // other config
  extends: [
    ... // other presets
    "plugin:oxlint/recommended",
  ],
}
```

### Detect rules from `.oxlintrc.json`

If you are using flat configuration (eslint >= 9.0), you can use the following config:

```js
// eslint.config.js
import oxlint from 'eslint-plugin-oxlint';
export default [
  ..., // other plugins
  ...oxlint.buildFromOxlintConfigFile('./.oxlintrc.json'),
];
```

Or build it by an `.oxlintrc.json`-like or `oxlint.config.ts` object:

```js
// eslint.config.js
import oxlint from 'eslint-plugin-oxlint';
export default [
  ..., // other plugins
  ...oxlint.buildFromOxlintConfig({
    categories: {
      correctness: 'warn'
    },
    rules: {
      eqeqeq: 'warn'
    }
  }),
];
```

`buildFromOxlintConfigFile` is not supported for legacy configuration (eslint < 9.0).

## All Configs

```js
  configs: {
    // recommended only contains the `correctness` category
    recommended: { plugins: [Array], rules: [Object] },
    'flat/recommended': { rules: [Object] },

    // all rules available
    all: { plugins: [Array], rules: [Object] },
    'flat/all': { rules: [Object] },

    // turn eslint rules off by plugin
    'flat/eslint': { rules: [Object] },
    'flat/import': { rules: [Object] },
    'flat/jest': { rules: [Object] },
    'flat/jsdoc': { rules: [Object] },
    'flat/jsx-a11y': { rules: [Object] },
    'flat/nextjs': { rules: [Object] },
    'flat/react': { rules: [Object] },
    'flat/react-perf': { rules: [Object] },
    'flat/tree-shaking': { rules: [Object] },
    'flat/typescript': { rules: [Object] },
    'flat/unicorn': { rules: [Object] },

    // turn eslint rules off by oxlint category
    'flat/pedantic': { rules: [Object] },
    'flat/style': { rules: [Object] },
    'flat/correctness': { rules: [Object] },
    'flat/restriction': { rules: [Object] },
    'flat/suspicious': { rules: [Object] }
  }
```

# [Sponsored By](https://oxc.rs/sponsor)

<p align="center">
  <a href="https://oxc.rs/sponsor">
    <img src="https://raw.githubusercontent.com/oxc-project/sponsors/main/sponsors.svg" alt="Our sponsors" />
  </a>
</p>

---
_Source: https://npm.io/package/eslint-plugin-oxlint · Machine-readable twin of the npm.io package page. Health data is recomputed on every publish._