todoq

Scan TODO comments and enrich with git blame — track technical debt as a timeline.

todoq walks your repo for TODO-family markers (TODO, FIXME, XXX, HACK, ...), then asks git blame who wrote each line and when. The result is a list of tickets ordered by age — debt becomes a chronology you can sort, filter, and grep.

Install

uvx todoq                  # one-shot run
uv tool install todoq      # persistent install

Usage

todoq takes mixed positional queries — paths, durations, git revs, or w/workset:

todoq                      # scan working tree
todoq 30d                  # only TODOs older than 30 days
todoq HEAD~50              # only TODOs introduced in last 50 commits
todoq src/                 # restrict to a path
todoq w                    # only TODOs on uncommitted lines (workset)
todoq -t FIXME -a alice    # filter by tag and author
todoq -S                   # summary stats instead of listing
todoq -f json              # machine-readable output

Multi-repo workspaces (.slnx-listed project dirs) are detected automatically; pass --no-workspace to scan the raw tree instead.

See todoq --help for the full option set.

Why

Most TODO scanners give you a flat list. todoq gives you a timeline — who wrote what debt, when, and how long it's been festering. The blame layer turns "scattered intentions" into accountable history.

License

MIT — see LICENSE.

Source

github.com/holo-q/todoq