| name | todo |
| description | Manage a TODO.md file at the project root. Add, complete, remove, and list tasks with priority levels. Use when the user says /todo or asks to manage tasks, todos, or action items. |
Todo Manager
Manage a TODO.md file at the project root using markdown checkboxes grouped by priority.
File Format
# TODO
## High Priority
- [ ] Incomplete task
- [x] Completed task
## Medium Priority
- [ ] Another task
## Low Priority
- [ ] Low priority task
Commands
Parse the user's intent from their message. Supported actions:
add [priority] [description]
Add a new item. Default priority is Medium if not specified.
- Read
TODO.md (create it with the # TODO header and all three priority sections if it doesn't exist)
- Add
- [ ] description under the matching priority section
- If the priority section doesn't exist, create it in order: High, Medium, Low
done [description or number]
Mark an item as complete.
- Read
TODO.md
- Find the matching item by description substring or by counting incomplete items (1-indexed)
- Change
- [ ] to - [x]
remove [description or number]
Remove an item entirely.
- Read
TODO.md
- Find the matching item by description substring or by counting all items (1-indexed)
- Delete the line
list
Show current todos with a summary.
- Read
TODO.md
- Display the contents
- Print a summary line:
X of Y tasks complete
next / work
Work on the next highest-priority incomplete item.
- Read
TODO.md
- Find the first
- [ ] item, scanning sections in order: High, Medium, Low
- Display the selected item to the user
- Begin working on it (implement the change, fix the bug, etc.)
- After completing the work, mark the item as
- [x] in TODO.md
Rules
- Always read
TODO.md before making any changes
- Preserve all existing content and formatting
- Within each section, keep incomplete items before completed items
- When creating
TODO.md, include all three sections (High, Medium, Low) even if empty
- If the user just says
/todo with no arguments, run list