listr2
11.4.0 · 17 Oct 2026MIT36.4M / weekRepositorynpmAtom feed
207 stable releases, newest first, by release line. Notes are quoted as the maintainers published them.
- 11.x · latest line
11.2.0
12 Oct 2026Maintenance only: docs, tests, build or refactoring. Nothing changes in how you use it.
11.1.1
1 Oct 2026deps: update node all minor dependency updates
11.1.0
2 Sep 2026Add 'info' figure
11.0.1
25 Aug 2026Only updates dependencies, nothing else changes.
11.0.0
21 Jul 2026- breaking
lib: Listr.errors is now
ListrError | null. With the defaultcollectErrors: [secure]it isnullinstead of an empty array; guard reads withlistr.errors?.lengthor an explicit null check. - breaking
lib: on interruption, tasks without a rollback are now marked as CANCELLED instead of FAILED, and the process exits only after in-flight rollbacks have settled. Custom renderers that switch on the task state must handle ListrTaskState.CANCELLED.
- breaking
lib: collectErrors no longer accepts 'minimal' or 'full', use true for the previous 'minimal' behavior. ListrError.ctx is removed and the context is no longer cloned into collected errors. The cloneObject utility export and the rfdc dependency are removed.
listr2 11.0.0 (2026-07-21)
Bug Fixes
lib: preserve OSC-8 hyperlinks in cleanseAnsi (#776) (4f6fc87), closes #768
lib: return null from Listr.errors when collection is disabled
renderer: derive wrap width from configured output stream
renderer: serialize the cancelled state in the test renderer
renderer: stop leaking output listeners on finalized tasks (1278eb5), closes #772
Features
lib: replace eventemitter3 with Node built-in EventEmitter
lib: reset a task's streamed output when set to null
lib: run rollback on interruption and add a cancelled task state
Performance Improvements
lib: drop rfdc and simplify collectErrors to a boolean
renderer: render task list with partial updates via log-update v8
Breaking changes
- breaking
lib: Listr.errors is now
ListrError | null. With the defaultcollectErrors: [secure]it isnullinstead of an empty array; guard reads withlistr.errors?.lengthor an explicit null check.
refs K-715
- breaking
lib: on interruption, tasks without a rollback are now marked as CANCELLED instead of FAILED, and the process exits only after in-flight rollbacks have settled. Custom renderers that switch on the task state must handle ListrTaskState.CANCELLED.
refs K-703
- breaking
lib: collectErrors no longer accepts 'minimal' or 'full', use true for the previous 'minimal' behavior. ListrError.ctx is removed and the context is no longer cloned into collected errors. The cloneObject utility export and the rfdc dependency are removed.
- 10.x
10.2.2
24 Jun 2026Reading the note…
10.2.1
2 Mar 2026Reading the note…
10.2.0
2 Mar 2026Reading the note…
10.1.2
1 Mar 2026Reading the note…
10.1.1
23 Feb 2026Reading the note…
10.1.0
26 Jan 2026Reading the note…
10.0.0
14 Jan 2026Reading the note…
- 9.x
9.0.5
20 Oct 2025Reading the note…
9.0.4
14 Sep 2025Reading the note…
9.0.3
30 Aug 2025Reading the note…
9.0.2
20 Aug 2025Reading the note…
9.0.1
11 Jul 2025Reading the note…
9.0.0
7 Jul 2025Reading the note…
- 8.x
8.3.3
6 May 2025Reading the note…
8.3.2
10 Apr 2025Reading the note…
8.3.1
9 Apr 2025Reading the note…
8.3.0
9 Apr 2025Reading the note…
8.2.5
3 Oct 2024Reading the note…
8.2.4
27 Jul 2024Reading the note…
8.2.3
21 Jun 2024Reading the note…
8.2.2
19 Jun 2024Reading the note…
8.2.1
3 Apr 2024Reading the note…
8.2.0
2 Apr 2024Reading the note…
8.1.3
31 Mar 2024Reading the note…
8.1.2
29 Mar 2024Reading the note…
8.1.1
27 Mar 2024Reading the note…
8.1.0
27 Mar 2024Reading the note…
8.0.2
27 Jan 2024Reading the note…
8.0.1
20 Dec 2023Reading the note…
8.0.0
24 Nov 2023Reading the note…
- 7.x
7.0.2
18 Oct 2023Reading the note…
7.0.1
19 Sep 2023Reading the note…
- 6.x
6.6.1
30 Jul 2023Reading the note…
6.6.0
17 May 2023Reading the note…
6.5.0
13 May 2023Reading the note…
6.4.2
3 May 2023Reading the note…
6.4.1
29 Apr 2023Reading the note…
6.4.0
28 Apr 2023Reading the note…
6.3.1
17 Apr 2023Reading the note…
6.3.0
16 Apr 2023Reading the note…
6.2.0
11 Apr 2023Reading the note…
6.1.0
11 Apr 2023Reading the note…
6.0.4
8 Apr 2023Reading the note…