Command-line Interface

Usage

oxlint [-c=<./.oxlintrc.json>] [PATH]...

Basic Configuration

• -c, --config=<./.oxlintrc.json> — Oxlint configuration file (experimental)

• only .json extension is supported

• you can use comments in configuration files.

• tries to be compatible with the ESLint v8's format

  If not provided, Oxlint will look for .oxlintrc.json in the current working directory.

• --tsconfig=<./tsconfig.json> — TypeScript tsconfig.json path for reading path alias and project references for import plugin
• --init — Initialize oxlint configuration with default values

Allowing / Denying Multiple Lints

Accumulate rules and categories from left to right on the command-line.

For example -D correctness -A no-debugger or -A all -D no-debugger. The categories are:

• correctness - code that is outright wrong or useless (default).
• suspicious - code that is most likely wrong or useless.
• pedantic - lints which are rather strict or have occasional false positives.
• style - code that should be written in a more idiomatic way.
• nursery - new lints that are still under development.
• restriction - lints which prevent the use of language and library features.
• all - all the categories listed above except nursery. Does not enable plugins automatically.

Arguments:

• -A, --allow=NAME — Allow the rule or category (suppress the lint)
• -W, --warn=NAME — Deny the rule or category (emit a warning)
• -D, --deny=NAME — Deny the rule or category (emit an error)

Enable Plugins

• --disable-unicorn-plugin — Disable unicorn plugin, which is turned on by default
• --disable-oxc-plugin — Disable oxc unique rules, which is turned on by default
• --disable-typescript-plugin — Disable TypeScript plugin, which is turned on by default
• --import-plugin — Enable the experimental import plugin and detect ESM problems. It is recommended to use along side with the --tsconfig option.
• --react-plugin — Enable react plugin, which is turned off by default
• --jsdoc-plugin — Enable the experimental jsdoc plugin and detect JSDoc problems
• --jest-plugin — Enable the Jest plugin and detect test problems
• --vitest-plugin — Enable the Vitest plugin and detect test problems
• --jsx-a11y-plugin — Enable the JSX-a11y plugin and detect accessibility problems
• --nextjs-plugin — Enable the Next.js plugin and detect Next.js problems
• --react-perf-plugin — Enable the React performance plugin and detect rendering performance problems
• --promise-plugin — Enable the promise plugin and detect promise usage problems
• --node-plugin — Enable the node plugin and detect node usage problems
• --regex-plugin — Enable the regex plugin and detect regex usage problems
• --vue-plugin — Enable the vue plugin and detect vue usage problems

Fix Problems

• --fix — Fix as many issues as possible. Only unfixed issues are reported in the output
• --fix-suggestions — Apply auto-fixable suggestions. May change program behavior.
• --fix-dangerously — Apply dangerous fixes and suggestions.

Ignore Files

• --ignore-path=PATH — Specify the file to use as your .eslintignore

• --ignore-pattern=PAT — Specify patterns of files to ignore (in addition to those in .eslintignore)

  The supported syntax is the same as for .eslintignore and .gitignore files You should quote your patterns in order to avoid shell interpretation of glob patterns

• --no-ignore — Disables excluding of files from .eslintignore files, --ignore-path flags and --ignore-pattern flags

NOTE

.gitignore is only respected inside a Git repository.

Handle Warnings

• --quiet — Disable reporting on warnings, only errors are reported
• --deny-warnings — Ensure warnings produce a non-zero exit code
• --max-warnings=INT — Specify a warning threshold, which can be used to force exit with an error status if there are too many warning-level rule violations in your project

Output

• -f, --format=ARG — Use a specific output format. Possible values: checkstyle, default, github, gitlab, json, junit, stylish, unix

Miscellaneous

• --silent — Do not display any diagnostics
• --threads=INT — Number of threads to use. Set to 1 for using only 1 CPU core
• --print-config — This option outputs the configuration to be used. When present, no linting is performed and only config-related options are valid.

Inline Configuration Comments

• --report-unused-disable-directives — Report directive comments like // eslint-disable-line when no errors would have been reported on that line anyway.
• --report-unused-disable-directives-severity=SEVERITY — Same as --report-unused-disable-directives, but allows you to specify the severity level of the reported errors. Only one of these two options can be used at a time.

Available positional items:

• PATH — Single file, single path or list of paths

Available options:

• --rules — list all the rules that are currently registered
• --disable-nested-config — Disables the automatic loading of nested configuration files.
• --type-aware — Enables rules that require type information.
• -h, --help — Prints help information
• -V, --version — Prints version information