Unearth Your Code’s Hidden TODOs & Supercharge Your Workflow with comment-todo!

[Ali nazari]

Ever lost track of those // TODO: refactor this or /* FIXME: edge case */ comments scattered across your codebase?

What if you could automatically extract them, organize them into a clean TODO.md, and never let a critical task slip through the cracks again?

Meet comment-todo — the CLI tool that does exactly that, and does it elegantly.

Why You’ll Love This Tool​

comment-todo isn’t just another code scanner. It’s AST-powered for JavaScript/TypeScript (so it ignores false positives in strings or regex), supports multiple languages (Python, PHP, Go, Shell, and more), and even parses metadata like assignees and due dates. Imagine turning this:

// TODO(@alice, due:2025-09-01): Add validation

Into a structured entry in your TODO.md!

Key Features​

• Smart Scanning: Uses AST parsing for JS/TS and fallback heuristics for other languages.
• Metadata Extraction: Captures assignees (@user), due dates (due:YYYY-MM-DD), and custom key-value pairs.
• Multi-Language Support: Works with JavaScript, TypeScript, Python, PHP, Go, Shell, and more.
• GitHub-Friendly Output: Generates a well-formatted TODO.md or JSON for automation.
• Lightning Fast: Concurrent file processing and minimal configuration.

Who Is This For?​

• Developers who want to track technical debt without leaving their IDE.
• Teams that need a centralized, auto-generated list of pending tasks.
• Open-Source Maintainers looking to streamline issue tracking and contributions.
• Anyone tired of losing TODOs in a sea of code!

How to Use It​

1. Install globally:

   npm install -g comment-todo

1. Run it in your project:

   comment-todo --out TODO.md

1. Boom! Your TODO.md is generated with all comments neatly organized.

Star It on GitHub!​

This project is 100% open-source and built to help developers like you. If you find it useful, please show some love on GitHub. Stars fuel motivation and help more people discover the tool!

What’s Next?​

I’m already working on features like custom tag support, IDE extensions, and Git integration. Want to contribute? PRs and ideas are welcome!

Try comment-todo today and never lose a TODO again!

GitHub Repo: https://github.com/Silent-Watcher/comment-todo

If you have questions drop a comment below!

Let’s connect!!:

LinkedIn
GitHub

Continue reading...

 

Join 𝕋𝕄𝕋 on Telegram
Channel PREVIEW: