command-todo-scan

A Claude Code slash command for finding and tracking TODO/FIXME comments in the codebase.

Installation

# Clone to your preferred location
git clone git@github.com:claude-commands/command-todo-scan.git <clone-path>/command-todo-scan

# Symlink (use full path to cloned repo)
ln -s <clone-path>/command-todo-scan/todo-scan.md ~/.claude/commands/todo-scan.md

Usage

/todo-scan                 # Scan entire project
/todo-scan src/            # Scan specific directory
/todo-scan --report        # Generate detailed report
/todo-scan --issues        # Create GitHub issues for TODOs
/todo-scan --priority      # Show by priority level

What it does

1. Searches for TODO, FIXME, HACK, BUG comments
2. Parses and categorizes findings
3. Extracts git context (author, age)
4. Generates summary report
5. Optionally creates GitHub issues

Pattern Priorities

Pattern	Priority	Description
FIXME	Critical	Needs immediate fix
BUG	Critical	Known bug
HACK	High	Temporary workaround
TODO	Medium	Planned improvement
REFACTOR	Low	Code cleanup

Output Format

TODO Scan Results

Summary:
| Type  | Count | Critical | High |
| ----- | ----- | -------- | ---- |
| FIXME | 8     | 8        | -    |
| TODO  | 45    | 5        | 15   |

Total: 75 items (16 critical)

Options

Option	Description
--report	Generate markdown report
--issues	Create GitHub issues
--priority	Sort by priority
--author	Filter by git blame author
--age	Filter by age

Requirements

• ripgrep (rg) for fast searching
• Git for blame information
• GitHub CLI (gh) for issue creation
• Claude Code with Opus 4.5 model access

Updates

cd <clone-path>/command-todo-scan && git pull