todo.py

A search utility for TODO statements
in codebases.

Info • Install • Usage
Screenshots • License

---

Features

• User-configurable keyword search term (default: TODO:)
• Automatically track how long a task has been ignored

Requirements

• Python (3.10+)
• Git

---

Install

Download todo.py from the repo

curl -O https://raw.githubusercontent.com/simon-danielsson/todo.py/refs/heads/main/src/todo.py
chmod +x todo.py
mv todo.py ~/my_scripts

Add a bash alias

#!/usr/bin/env bash

alias todo="$HOME/my_scripts/todo.py"

---

Usage

Usage: todo [OPTIONS]

Options:
-k  <keyword>    Keyword to search for (default: "TODO:")
-c, --no-color   Disable color output (default: enabled)
-h, --help       Show this help message and exit

---

Screenshots

---

License

This project is licensed under the MIT License.