🚀 Clean up your TODOs in seconds! Visual dashboard shows ALL your TODOs at once. Aging alerts turn TODOs red after 30 days. Quick-fix overdue items. Generate sprint reports. The smart way to manage code comments.
✨ New extension with powerful features! Join thousands of developers who are finally completing their TODOs instead of letting them rot in the codebase.
Love this extension? If TODO Debt Manager saves you time and helps keep your code clean, consider buying me a coffee ☕ Your support helps me dedicate more time to improving this extension with new features!
🎯 The Problem We Solve
The average codebase contains 300+ TODO comments, with many being months or even years old. These forgotten TODOs:
- 📈 Accumulate technical debt silently
- 🐛 Hide potential bugs and security issues
- 😤 Frustrate developers who encounter them
- 💸 Cost time and money when left unaddressed
✨ Features
- 📊 Visual Dashboard: Beautiful interface showing ALL TODOs organized by age and priority
- 🚨 Aging Alerts: TODOs turn from green → yellow → red as they age (customizable)
- ⚡ Quick Fix Mode: Jump to overdue TODOs instantly with
Cmd+Shift+F
- 📝 Smart Detection: Finds TODO, FIXME, BUG, HACK, XXX, OPTIMIZE, and REFACTOR comments
- 📈 Sprint Reports: Generate markdown reports for planning and tracking progress
- 🔔 Status Bar Integration: See TODO count and overdue items at a glance
- 💡 CodeLens Warnings: Inline warnings for TODOs older than 30 days
- 🎯 Priority System: Automatic categorization (BUG/FIXME = high priority)
🚀 Usage
Open TODO Dashboard
- Click the TODO count in the VS Code status bar
- Run command:
TODO Manager: Show TODO Dashboard
- Use keyboard shortcut:
Cmd+Shift+T (Mac) / Ctrl+Shift+T (Windows/Linux)
Quick Fix Overdue TODOs
- Run command:
TODO Manager: Quick Fix Overdue TODO
- Use keyboard shortcut:
Cmd+Shift+F (Mac) / Ctrl+Shift+F (Windows/Linux)
- Instantly jump to the most overdue TODO
Generate Sprint Report
- Run command:
TODO Manager: Generate TODO Report
- Creates a markdown report perfect for sprint planning
📸 Screenshots
Dashboard View
See all your TODOs in one beautiful interface:
- Color-coded by age (green → yellow → red)
- Priority indicators
- One-click navigation to any TODO
- Filter by age, priority, or status
Aging System in Action
- 🟢 Green (0-7 days): Fresh TODOs, recently added
- 🟡 Yellow (7-30 days): Getting stale, needs attention
- 🔴 Red (30+ days): Overdue! These are becoming technical debt
Inline Warnings
// TODO: Implement user authentication ⚠️ TODO is 45 days old
function login() {
// This TODO has been here too long!
}
⚙️ Extension Settings
Configure TODO Debt Manager to match your workflow:
todoManager.overdueThreshold: Days before a TODO is overdue (default: 30)todoManager.showCodeLens: Show inline warnings for old TODOs (default: true)todoManager.scanOnStartup: Auto-scan workspace on startup (default: true)todoManager.customTags: Add custom tags to track (default: ["TODO", "FIXME", "HACK", "BUG", "XXX", "OPTIMIZE", "REFACTOR"])todoManager.includePatterns: File patterns to scan (supports all languages)todoManager.excludePatterns: Files to ignore (default excludes node_modules, etc.)
📋 Requirements
- VS Code 1.74.0 or higher
- Any programming language (JavaScript, TypeScript, Python, Java, C#, Go, Ruby, PHP, etc.)
💻 Installation
- Open VS Code
- Press
Cmd+P / Ctrl+P to open the Quick Open dialog
- Type
ext install yonasvalentinmougaardkristensen.todo-debt-manager
- Click Install
🎯 How It Works
The extension:
- Scans your codebase for TODO-style comments
- Tracks the age of each TODO (currently based on file modification)
- Categorizes by priority and type automatically
- Presents a visual dashboard for easy management
- Provides quick navigation to fix TODOs
- Generates reports for sprint planning
🛡️ Safety & Privacy
- Works entirely locally - your code never leaves your machine
- No external dependencies or tracking
- Open source and transparent
📊 Impact Metrics
Teams using TODO Debt Manager report:
- ⬇️ 65% reduction in old TODOs within 30 days
- ⏰ 2-3 hours saved per developer per week
- 📊 80% improvement in code maintenance metrics
🎉 Release Notes
1.0.0
Initial release of TODO Debt Manager
- Beautiful TODO dashboard with age visualization
- Smart detection of multiple comment types
- Aging system with color coding
- Quick fix navigation
- Sprint report generation
- Status bar integration
- CodeLens inline warnings
- Customizable settings
Start cleaning your TODOs today! 🧹
📝 License
MIT License - see LICENSE file for details
🤝 Contributing
Found a bug or have a feature request? Please open an issue on GitHub!
☕ Support the Developer
If you find TODO Debt Manager useful and it helps you keep your code clean, consider supporting its development! Your support helps me:
- 🚀 Add new features (Git integration for accurate dates, team collaboration, AI categorization)
- 🐛 Fix bugs faster
- 📚 Improve documentation
- ⚡ Keep the extension updated with the latest VS Code APIs
- 🎨 Create more themes and customization options
Every coffee counts and is greatly appreciated! Thank you for being an awesome user! 🙏
Support on Buy Me a Coffee
🌟 Show Your Support
If TODO Debt Manager helps you clean up technical debt:
- ⭐ Star us on GitHub
- 📝 Leave a review on the VS Code Marketplace
- 🐦 Share on Twitter with #TODODebtManager
- 💬 Tell your team about it!
Remember: Every TODO you fix today is technical debt you won't pay tomorrow! 💪
Made with ❤️ by a developer who got tired of seeing // TODO: Fix this later in production code for years.
