npm / @antfu/ni

@antfu/ni

What changed in @antfu/ni 26 to 30, from its official release notes, upgrade guides and advisories. Sources checked 2026-10-19.

2 breaking11 new APIs and options1 behavior and defaults7 tooling11 fixes and other

See which of these apply to your code, ranked, in your agent:

npx @unstale/cli init

@unstale/cli 0.2.0 on npm

@antfu/ni 3019 changes

Breaking changes 1

Node.js >=20.19.0 is now required to use @antfu/ni.
30.0.0release notes

New APIs and options 6

Adds an existing mode that only reuses existing catalog entries.
30.6.0release notes
Adds support for nub as a package manager.
30.6.0release notes
Adds a flag to prefer local binaries.
30.4.0release notes
Adds the --agent flag to print the detected package manager name.
30.1.0release notes
Adds the ? dry-run flag to the --help output.
30.1.0release notes
Adds the noLastCommand configuration option for nr.
30.1.0release notes

Behavior and default changes 1

Reuses the previous catalog choice when installing multiple packages.
30.4.0release notes

Tooling 4

Supports bun catalogs, allowing @antfu/ni to work with projects that use them.
30.5.0release notes
Adds support for aube as a package manager.
30.4.0release notes
Support yarn catalogs.
30.2.0release notes
Dependencies in package.json are sorted alphabetically, making dependency lists consistent.
30.0.0release notes

Fixes and other changes 7

Splits name@version before using it as a catalog key.
30.6.0release notes
Warns about unreadable and unrecognised .nirc options.
30.6.0release notes
Reads package.json files written in JSONC.
30.6.0release notes
Detection of --agent is non-interactive.
30.3.0release notes
Preserves forwarded -p arguments.
30.3.0release notes
System package manager binaries are preferred.
30.3.0release notes
Fixes workspace flag parsing in the nr command.
30.1.0release notes

@antfu/ni 291 changes

Tooling 1

Adds support for pnpm catalogs.
29.0.0release notes

@antfu/ni 287 changes

Breaking changes 1

nun uses multi-select by default.
28.0.0release notes

New APIs and options 2

The CLI supports the --programmatic flag in its arguments.
28.3.0release notes
Run tasks before agent detection.
28.2.0release notes

Tooling 1

Fish shell completion support was added for nr.
28.0.0release notes

Fixes and other changes 3

Prevent the agent prompt when using completion flags.
28.2.0release notes
Corrects the command structure used by nr with node --run.
28.1.0release notes
Pressing ESC now cancels nr in interactive mode.
28.0.0release notes

@antfu/ni 273 changes

New APIs and options 2

Adds the nd command.
27.0.0release notes
Adds support for Node.js --run when using nr.
27.0.0release notes

Fixes and other changes 1

Ctrl+C is handled during interactive installs.
27.0.1release notes

@antfu/ni 262 changes

New APIs and options 1

Adds sfw integration, allowing developers to use ni with sfw.
26.2.0release notes

Tooling 1

Adds support for Bun's new interactive upgrade command.
26.2.0release notes