# listr2

> Terminal task list reborn! Create beautiful CLI interfaces via easy and logical to implement task lists that feel alive and interactive.

Latest version **11.1.0** (published 2026-09-02) · MIT license · 0 weekly downloads

## Install

```sh
npm install listr2
pnpm add listr2
yarn add listr2
bun add listr2
```

## Health

**Score 70/100 (B)** — status: active.

Positive: has types; esm support; no vulnerabilities; recently updated; high maintenance score; high quality score.

Warnings: low downloads.

## Facts

| | |
|---|---|
| Version | 11.1.0 |
| Published | 2026-09-02 |
| First published | 2020-02-29 |
| Weekly downloads | 0 |
| License | MIT |
| TypeScript types | bundled |
| Module format | ESM + CommonJS |
| Node | >=22.13.0 |
| Dependencies | 3 |
| Unpacked size | 133.7 KB |
| Known vulnerabilities | 0 |
| Install scripts | no |
| GitHub stars | 686 |
| Author | Cenk Kilic |
| Maintainers | cenk1cenk2 |
| Keywords | listr, listr2, cli, task, list, tasklist, terminal, term, console, ascii, unicode, loading, indicator, progress, busy, wait, idle |

## Links

- npm: https://www.npmjs.com/package/listr2
- Repository: https://github.com/listr2/listr2
- Homepage: https://github.com/listr2/listr2#readme
- Issues: https://github.com/listr2/listr2/issues
- npm.io page: https://npm.io/package/listr2

## Dependencies (3)

- [wrap-ansi](https://npm.io/package/wrap-ansi.md) ^10.0.1
- [log-update](https://npm.io/package/log-update.md) ^8.0.0
- [cli-truncate](https://npm.io/package/cli-truncate.md) ^6.1.1

## Alternatives

- [@salesforce/cli](https://npm.io/package/@salesforce/cli.md) — 389.7K weekly downloads
- [@mintlify/cli](https://npm.io/package/@mintlify/cli.md) — 208.9K weekly downloads
- [@grafana/e2e-selectors](https://npm.io/package/@grafana/e2e-selectors.md) — 128.7K weekly downloads
- [mintlify](https://npm.io/package/mintlify.md) — 112.0K weekly downloads
- [@intlayer/cli](https://npm.io/package/@intlayer/cli.md) — 22.8K weekly downloads

## Recent versions

- 11.1.0 (latest) — 2026-09-02
- 11.0.0-beta.7 (beta) — 2026-07-21
- 11.0.1 — 2026-08-25
- 11.0.0 — 2026-07-21
- 11.0.0-beta.6 — 2026-07-21
- 11.0.0-beta.5 — 2026-07-21
- 11.0.0-beta.4 — 2026-07-20
- 11.0.0-beta.3 — 2026-07-20
- 11.0.0-beta.2 — 2026-07-13
- 11.0.0-beta.1 — 2026-07-12
- 10.3.0-beta.1 — 2026-07-12
- 10.2.2 — 2026-06-24
- 10.2.1 — 2026-03-02
- 10.2.0 — 2026-03-02
- 10.1.2 — 2026-03-01
- … 249 more at https://npm.io/package/listr2/versions

## README

# listr2

[![Pipeline](https://gitlab.kilic.dev/libraries/listr2/badges/master/pipeline.svg?style=flat-square&ignore_skipped=true)](https://gitlab.kilic.dev/libraries/listr2/-/commits/master) [![Version](https://img.shields.io/npm/v/listr2.svg?style=flat-square&logo=npm)](https://www.npmjs.com/package/listr2?activeTab=versions) [![Downloads](https://img.shields.io/npm/dm/listr2.svg?style=flat-square&logo=npm)](https://www.npmjs.com/package/listr2) [![NPM Unpacked Size](https://img.shields.io/npm/unpacked-size/listr2)](https://www.npmjs.com/package/listr2) [![Dependencies](https://img.shields.io/librariesio/release/npm/listr2?style=flat-square&logo=npm)](https://www.npmjs.com/package/listr2?activeTab=dependencies) [![codecov](https://codecov.io/gh/listr2/listr2/branch/master/graph/badge.svg?style=flat-square)](https://codecov.io/gh/listr2/listr2)

[![github sponsors](https://img.shields.io/github/sponsors/cenk1cenk2?style=flat-square&logo=github)](https://github.com/sponsors/cenk1cenk2) [![opencollective](https://img.shields.io/opencollective/sponsors/listr2?label=open%20collective&logo=opencollective)](https://opencollective.com/listr2)

**Create beautiful CLI interfaces via easy and logical to-implement task lists that feel alive and interactive.**

---

## Documentation

**[Read the documentation...](https://listr2.kilic.dev)**

## Demo

![Demo](https://media.githubusercontent.com/media/listr2/listr2/master/examples/renderer-default.gif)

---
_Source: https://npm.io/package/listr2 · Machine-readable twin of the npm.io package page. Health data is recomputed on every publish._