PHPackages                             k00ni/todolo - 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. k00ni/todolo

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

k00ni/todolo
============

Keep track of TODOs all over your files by listing them on the terminal.

0.1.2(6y ago)1451MITPHPPHP ^7.1CI failing

Since Jul 29Pushed 6y ago1 watchersCompare

[ Source](https://github.com/k00ni/todolo)[ Packagist](https://packagist.org/packages/k00ni/todolo)[ RSS](/packages/k00ni-todolo/feed)WikiDiscussions master Synced today

READMEChangelog (3)Dependencies (5)Versions (4)Used By (0)

todolo
======

[](#todolo)

[![Build Status](https://camo.githubusercontent.com/2af02b224d51f5e5bd55538c220cf61d47837628911aec4d2f9035ef87437166/68747470733a2f2f7472617669732d63692e636f6d2f6b30306e692f746f646f6c6f2e7376673f6272616e63683d6d6173746572)](https://travis-ci.com/k00ni/todolo)[![Code Coverage](https://camo.githubusercontent.com/8eab05f6e43098541a3822c8cc5e11b3998161aa391f486f71c4c992a2776e5a/68747470733a2f2f7363727574696e697a65722d63692e636f6d2f672f6b30306e692f746f646f6c6f2f6261646765732f636f7665726167652e706e673f623d6d6173746572)](https://scrutinizer-ci.com/g/k00ni/todolo/?branch=master)[![Scrutinizer Code Quality](https://camo.githubusercontent.com/64e95560f800c4abb7c3bc16cec9b7108503c27dce4d3d47a40eb19614a8e23b/68747470733a2f2f7363727574696e697a65722d63692e636f6d2f672f6b30306e692f746f646f6c6f2f6261646765732f7175616c6974792d73636f72652e706e673f623d6d6173746572)](https://scrutinizer-ci.com/g/k00ni/todolo/?branch=master)

About
-----

[](#about)

Todolo helps you to keep track of TODO, FIXME etc. all over your files. It shows a list of files with all related TODO messages on the terminal.

We are following semantic versioning () but until we reach 1.0.0 breaking changes are possible. Upgrade introductions will be described in an UPGRADE file.

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

[](#installation)

Please install `k00ni/todolo` with composer.

Usage
-----

[](#usage)

Run

> vendor/bin/todolo

in the root folder of your project. If files in your `src` folder contain TODO's like

> // TODO foobar

it may print something like the following on the terminal:

```
-----------------------------------------------------
tests/Integration/TodoFinderTest.php
-----------------------------------------------------
- TODO 1
- FIXME 2
- Foobar

-----------------------------------------------------
tests/Integration/Helper/OutputHelperTest.php
-----------------------------------------------------
No TODOs found.
-----------------------------------------------------

```

Config
------

[](#config)

**Complete config example:**

```
return [
    'dirs_to_check' => [
        'src',
    ],
    // show
    'show_empty_dir' => false,
    'show_files_with_no_todos' => false,
    'show_no_files_info' => true,
];
```

### dirs\_to\_check

[](#dirs_to_check)

List all folders you wanna include in the TODO collection.

Example:

```
return [
    'dirs_to_check' => [
        'src',
    ],
];
```

### show\_empty\_dir

[](#show_empty_dir)

If set to `true` it will show empty dirs in the output later on.

Example:

```
return [
    'show_empty_dir' => true,
];
```

### show\_files\_with\_no\_todos

[](#show_files_with_no_todos)

If set to `true` it will show files which have no TODOs inside.

Example:

```
return [
    'show_files_with_no_todos' => true,
];
```

### show\_no\_files\_info

[](#show_no_files_info)

If set to `true` it will show info if a dir has no files inside.

Example:

```
return [
    'show_no_files_info' => true,
];
```

###  Health Score

23

—

LowBetter than 25% of packages

Maintenance20

Infrequent updates — may be unmaintained

Popularity14

Limited adoption so far

Community7

Small or concentrated contributor base

Maturity43

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 ~5 days

Total

3

Last Release

2200d ago

### Community

Maintainers

![](https://www.gravatar.com/avatar/cc012239e82798bfbf91be6fa4c1a2cb0c1f0faa738de0865d954daa5d98bb3d?d=identicon)[k00ni](/maintainers/k00ni)

---

Top Contributors

[![k00ni](https://avatars.githubusercontent.com/u/381727?v=4)](https://github.com/k00ni "k00ni (28 commits)")

---

Tags

clitodotodolist

###  Code Quality

TestsPHPUnit

Static AnalysisPHPStan

Code StylePHP CS Fixer

Type Coverage Yes

### Embed Badge

![Health badge](/badges/k00ni-todolo/health.svg)

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

###  Alternatives

[composer/composer

Composer helps you declare, manage and install dependencies of PHP projects. It ensures you have the right stack everywhere.

29.5k199.6M3.4k](/packages/composer-composer)[friendsofphp/php-cs-fixer

A tool to automatically fix PHP code style

13.5k257.0M27.9k](/packages/friendsofphp-php-cs-fixer)[ssch/typo3-rector

Instant fixes for your TYPO3 PHP code by using Rector.

2613.3M489](/packages/ssch-typo3-rector)[helsingborg-stad/municipio

A bootstrap theme for creating municipality sites.

4028.6k10](/packages/helsingborg-stad-municipio)[ymirapp/cli

Ymir command-line tool

2622.2k](/packages/ymirapp-cli)

PHPackages © 2026

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