# eslint-plugin-todo-plz

> Enforce consistent and maintainable TODO comments

Latest version **1.4.0** (published 2026-08-21) · MIT license · 0 weekly downloads

## Install

```sh
npm install eslint-plugin-todo-plz
pnpm add eslint-plugin-todo-plz
yarn add eslint-plugin-todo-plz
bun add eslint-plugin-todo-plz
```

## Health

**Score 55/100 (C)** — status: active.

Positive: no vulnerabilities; recently updated; high maintenance score.

Warnings: low downloads; no types; no esm support.

## Facts

| | |
|---|---|
| Version | 1.4.0 |
| Published | 2026-08-21 |
| First published | 2020-07-17 |
| Weekly downloads | 0 |
| License | MIT |
| TypeScript types | none |
| Module format | CommonJS |
| Dependencies | 0 |
| Known vulnerabilities | 0 |
| Install scripts | no |
| GitHub stars | 31 |
| Author | Sawyer Hollenshead |
| Maintainers | sawyerh |
| Keywords | eslint, eslintplugin, eslint-plugin, linter, lint |

## Links

- npm: https://www.npmjs.com/package/eslint-plugin-todo-plz
- Repository: https://github.com/sawyerh/eslint-plugin-todo-plz
- Homepage: https://github.com/sawyerh/eslint-plugin-todo-plz#readme
- Issues: https://github.com/sawyerh/eslint-plugin-todo-plz/issues
- npm.io page: https://npm.io/package/eslint-plugin-todo-plz

## Alternatives

- [eslint-plugin-sonarjs](https://npm.io/package/eslint-plugin-sonarjs.md) — 2.9M weekly downloads
- [eslint-config-expo](https://npm.io/package/eslint-config-expo.md) — 1.5M weekly downloads
- [@matter/protocol](https://npm.io/package/@matter/protocol.md) — 63.5K weekly downloads
- [@eventcatalog/linter](https://npm.io/package/@eventcatalog/linter.md) — 24.8K weekly downloads
- [@inrupt/eslint-config-base](https://npm.io/package/@inrupt/eslint-config-base.md) — 4.5K weekly downloads

## Recent versions

- 1.4.0 (latest) — 2026-08-21
- 1.3.2 — 2026-05-31
- 1.3.1 — 2024-06-16
- 1.3.0 — 2022-09-12
- 1.2.1 — 2021-10-16
- 1.2.0 — 2021-05-12
- 1.1.0 — 2020-07-17
- 1.0.2 — 2020-07-17
- 1.0.1 — 2020-07-17
- 1.0.0 — 2020-07-17

## README

# eslint-plugin-todo-plz

Enforce consistent and maintainable TODO comments.

![Screenshot](.github/assets/screenshot.png)

## Installation

You'll first need to install [ESLint](http://eslint.org):

```
$ npm i eslint --save-dev
```

Next, install `eslint-plugin-todo-plz`:

```
$ npm install eslint-plugin-todo-plz --save-dev
```

## Usage

Import `eslint-plugin-todo-plz` in your `eslint.config.js`, register it under
`plugins`, and configure the rules you want to use:

```js
const todoPlz = require("eslint-plugin-todo-plz");

module.exports = [
  {
    plugins: {
      "todo-plz": todoPlz,
    },
    rules: {
      "todo-plz/ticket-ref": ["error", { pattern: "PROJ-[0-9]+" }],
    },
  },
];
```

## Supported Rules

- [`ticket-ref`](docs/rules/ticket-ref.md)

## Inspiration

- Shoutout [`expiring-todo-comments`](https://github.com/sindresorhus/eslint-plugin-unicorn/blob/master/docs/rules/expiring-todo-comments.md) for showing me how to build my first ESLint rule.

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