npm / listr2

listr2

What changed in listr2 9 to 11, from its official release notes, upgrade guides and advisories. Sources checked 2026-10-17.

5 breaking2 new APIs and options1 performance4 behavior and defaults1 tooling7 fixes and other

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

npx @unstale/cli init

listr2 1115 changes

collectErrors no longer accepts 'minimal' or 'full'; use true for the previous 'minimal' behavior.
11.0.0release notes
Listr.errors is now ListrError[] or null; with the default collectErrors setting, it is null instead of an empty array.
11.0.0release notes
ListrError.ctx is removed, and collected errors no longer contain cloned context.
11.0.0release notes
On interruption, tasks without a rollback are marked CANCELLED instead of FAILED; the process exits after in-flight rollbacks settle.
11.0.0release notes

A separate TITLE_RESET event is emitted when a title is reset.
11.3.0release notes
Adds the info figure for developers to use.
11.1.0release notes

Retries stop when a task returns task.fail.
11.4.0release notes
Setting a task's title to undefined removes the title.
11.3.0release notes
The library replaces eventemitter3 with Node's built-in EventEmitter.
11.0.0release notes
Setting a task's streamed output to null resets it.
11.0.0release notes

The test renderer now serializes the cancelled state.
11.0.0release notes
cleanseAnsi now preserves OSC-8 hyperlinks.
11.0.0release notes
Finalized tasks no longer leak output listeners.
11.0.0release notes
The renderer derives wrap width from the configured output stream.
11.0.0release notes

Node.js 20 support was dropped because it is reaching end of life.
10.0.0release notes

Fixes a problem with statically passed values.
10.1.2release notes
Suppresses specific readline close errors during cancellation cleanup on Node.js 22 and 24, while still allowing prompts to be cancelled and cleaned up.
10.0.0release notes