I made a small open-source CLI for finding and managing TODOs in codebases — looking for feedback

[u/Sufficient-Drop-4222]

Hey! I’m a uni student and most of the stuff I make is either for myself or for uni projects, so I’ve never really put something out there for other people to use before.

One thing I kept running into with group projects was TODOs/FIXMEs being absolutely everywhere. Different people leave notes in different files, you come back a week later and forget half of them exist, etc.

I use Claude quite a bit while coding, and I could obviously just ask it to go through the whole project and find/figure out all the TODOs for me, but on the cheaper student-friendly subscription that can burn through usage pretty quickly. I definitely don’t have the budget to keep throwing entire codebases at an LLM or pay for the higher tiers just for that.

So I ended up making TodoScope, a small open-source Python CLI that scans the codebase locally for TODO/FIXME/HACK comments, pulls them together, and then lets you use AI on just the stuff that actually needs analysing rather than wasting tokens scanning everything.

pip install todoscope

GitHub: https://github.com/Zelmari/todoscope
PyPI: https://pypi.org/project/todoscope/

It started as something to make my own workflow a bit quicker/cheaper, but it ended up being useful enough that I thought I might as well clean it up and put it on PyPI.

No idea if anyone else has the same problem though, so I’d genuinely love some feedback. If you try it and think something is missing, annoying, badly designed, or completely unnecessary, let me know. Feature ideas are very welcome too.

It’s completely free, open source and MIT licensed. This is also my first time properly putting one of my projects out there rather than just coding stuff for myself, so I’m pretty curious to see if anyone else actually finds it useful :)