eslint-nibble

library9.1.1jsnpmunverified

eslint-nibble is an interactive ESLint wrapper that lets you fix linting errors one rule at a time, making it easier to adopt ESLint in large codebases. Version 9.1.1 supports ESLint 7, 8, and 9, with Node >=18. Unlike mass autofix, it lets you selectively apply fixes per rule, providing a focused workflow. It uses eslint-stats for rule overview and a friendly formatter for detailed errors. No bundled ESLint; uses your project's existing ESLint installation.

testing

npm install eslint-nibble

github ↗package ↗

INSTALL

IMPORT

SIG · ESLINT-NIBBLE

eslint-nibble

testingjavascriptv9.1.1

Install

—

Import

—

Disk

—

Pass rate

0/ 6

Env Coverage0 / 6

glibc

18–22

musl

18–22

Install & Compatibility

Where this runs

tested against v? · npm install

Install × environment matrix

Each cell = how many times install + import succeeded across repeated harness runs. Partial = flaky.
glibc = Debian/Ubuntu slim · musl = Alpine Linux

musl

node 18–226 runs

build_error

glibc

node 18–226 runs

build_error

Code

Verified usage

Verified import paths — ran on the pinned version, not inferred.

default (CLI)

✓ npx eslint-nibble src/

✗ npm run nibble -- --fix (overwrites files without prompting)

Used via CLI, not programmatic import. Run with npx or as a script.

fixNibbles

✓ import { fixNibbles } from 'eslint-nibble';

✗ const fixNibbles = require('eslint-nibble');

Exported as ESM only since v9.0; CJS require may fail.

nibble (deprecated)

✓ import { nibble } from 'eslint-nibble';

✗ const { nibble } = require('eslint-nibble');

Deprecated in v8.0.2 in favor of fixNibbles. Prefer fixNibbles.

Shows how to run eslint-nibble via CLI with npx and programmatically using the fixNibbles export.

// First, ensure eslint is installed in your project // npm install --save-dev eslint eslint-nibble // Then run via npx npx eslint-nibble src/ // Or use fixNibbles programmatically (ESM only) import { fixNibbles } from 'eslint-nibble'; async function runNibble() { const result = await fixNibbles({ eslintOptions: { extensions: ['.js', '.ts'], cache: true, cacheLocation: '.eslintcache', }, files: ['src/'], }); console.log('Done!'); } runNibble();

eslint-nibble --version

Debug

Known issues

breakingNode >=18 required as of v9.0; drops support for Node 12-16.

fix

Upgrade Node.js to version 18 or higher.

affects: >=9.0

breakingESLint 6 and below no longer supported as of v8.0; use v7 of eslint-nibble if you need older ESLint.

fix

Remove old ESLint and install ESLint 7, 8, or 9.

affects: >=8.0

deprecatedThe --ext option no longer defaults to .js as of v9.0; must specify explicitly for ESLint <9.

fix

Use --ext .js,.jsx or migrate to ESLint 9 where --ext is removed.

affects: >=9.0

gotchaProgrammatic API changed in v8.0.2: 'nibble' is deprecated, use 'fixNibbles' instead.

fix

Replace imports of 'nibble' with 'fixNibbles'.

affects: >=8.0.2

gotchaeslint-nibble does not bundle ESLint; you must install eslint separately.

fix

Run 'npm install --save-dev eslint' in your project.

affects: >=5.0

Errors

Common errors & fixes

Cannot find module 'eslint'

eslint is not installed as a peer dependency.

fix

Install eslint: npm install --save-dev eslint

Error: No files matching 'src/**' were found. (eslint-nibble)

The glob pattern doesn't match any files.

fix

Verify the path or use a broader glob (e.g., src/ instead of src/**).

TypeError: (0 , nibble_1.fixNibbles) is not a function

Using CommonJS require instead of ESM import.

fix

Switch to ESM: use import { fixNibbles } from 'eslint-nibble' or set type:"module" in package.json.

Upgrade

Version history

9.1.1latest on npm

Audit

Dependencies

eslintrequiredPeer dependency; eslint-nibble does not bundle ESLint and uses the version installed in your project.

Agent activity

2 hits · last 30 days

node

Resources

githubhttps://github.com/IanVS/eslint-nibble ↗

packagehttps://www.npmjs.com/package/eslint-nibble ↗