PHPackages                             agencenous/todo - PHPackages - PHPackages  [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register)

1. [Directory](/)
2. /
3. [CLI & Console](/categories/cli)
4. /
5. agencenous/todo

ActiveProject[CLI & Console](/categories/cli)

agencenous/todo
===============

CLI utility to check TODOs comments in projects

1.1.1(1y ago)02.7k↓75.7%GPL-3.0PHP

Since Sep 16Pushed 1y ago1 watchersCompare

[ Source](https://github.com/agencenous/todo)[ Packagist](https://packagist.org/packages/agencenous/todo)[ RSS](/packages/agencenous-todo/feed)WikiDiscussions main Synced yesterday

READMEChangelog (3)DependenciesVersions (4)Used By (0)

TODO
====

[](#todo)

CLI utility to check TODOs comments in projects

Installation
------------

[](#installation)

```
composer require --dev agencenous/todo
```

Usage
-----

[](#usage)

```
vendor/bin/todo
```

By default, the command will search for `TODO:` comments in the current directory and its subdirectories in files with format: php, js, css, scss, jsx.

Some directories are excluded by default: `vendor`, `node_modules`, `cache`, `.git`.

You can override these settings by passing arguments to the command:

```
vendor/bin/todo path/to/directory --formats=php,js,css,scss,jsx --exclude=vendor,node_modules,cache,.git
```

For a more convenient use, you can also create a configuration file `.todo.json` at the root of your project:

```
{
    "formats": ["php", "js", "css", "scss", "jsx"],
    "exclude": ["vendor", "node_modules", "cache", ".git"]
}
```

Example
-------

[](#example)

```
vendor/bin/todo
```

output (colorized):

```
./src/Controller/ApiController.php
- Line 422: "Apply pagination in query instead of post-processing"
./src/Front/components/DateView/index.js
- Line 7: "add format parameter to format the date"
./src/Helper/Apps/GoogleHelper.php
- Line 327: "Implete update event"
- Line 374: "Implete delete event"

 Found 4 TODOs

```

If TODOs are found, the command will exit with status code 1, otherwise it will exit with status code 0.

###  Health Score

28

—

LowBetter than 52% of packages

Maintenance34

Infrequent updates — may be unmaintained

Popularity20

Limited adoption so far

Community7

Small or concentrated contributor base

Maturity42

Maturing project, gaining track record

 Bus Factor1

Top contributor holds 100% of commits — single point of failure

How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window.

**Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores.

**Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement.

**Maturity (30%)** — Project age, version count, PHP version support, and release stability.

###  Release Activity

Cadence

Every ~4 days

Total

3

Last Release

647d ago

### Community

Maintainers

![](https://www.gravatar.com/avatar/711568ddabbb0c5607b7bc77660a2094b8f32514d4a2bafcd2f8bba7caefb4d7?d=identicon)[bastienho](/maintainers/bastienho)

---

Top Contributors

[![bastienho](https://avatars.githubusercontent.com/u/2409849?v=4)](https://github.com/bastienho "bastienho (12 commits)")

### Embed Badge

![Health badge](/badges/agencenous-todo/health.svg)

```
[![Health](https://phpackages.com/badges/agencenous-todo/health.svg)](https://phpackages.com/packages/agencenous-todo)
```

###  Alternatives

[illuminate/console

The Illuminate Console package.

13046.0M6.5k](/packages/illuminate-console)[styleci/cli

The CLI tool for StyleCI

71470.5k9](/packages/styleci-cli)[winbox/args

Windows command-line formatter

20720.9k21](/packages/winbox-args)[tomatophp/filament-artisan

Simple but yet powerful library for running some artisan commands for FilamentPHP

3275.4k1](/packages/tomatophp-filament-artisan)[thettler/laravel-console-toolkit

This Package provides some usefully console features like the attribute syntax for arguments and options, validation, auto ask and casting.

324.1k](/packages/thettler-laravel-console-toolkit)

PHPackages © 2026

[Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)