Stats
Actions
Tags
From todo
List all todo files in the current repo with their status and priority
How this command is triggered — by the user, by Claude, or both
Slash command
/todo:list-todos [object Object]This command is limited to the following tools:
The summary Claude sees in its command listing — used to decide when to auto-load this command
# List Todos Show a summary of all todo files in `dev_docs/todos/`. ## Steps ### 1. Find todo files If the directory doesn't exist or is empty, report "No todos found in this repo." ### 2. Parse and filter For each file, parse the YAML frontmatter to extract: `title`, `priority`, `status`, `created`, `expires`, `tags`. Check for expired todos: if `expires` < today and `status` is `unclaimed`, mark as expired. If `$ARGUMENTS` is provided, filter to that status. Default: show all. ### 3. Display Format as a table sorted by priority (high first), then age (oldest first): Include...
Show a summary of all todo files in dev_docs/todos/.
find "$(git rev-parse --show-toplevel)/dev_docs/todos" -name '*.md' -type f 2>/dev/null
If the directory doesn't exist or is empty, report "No todos found in this repo."
For each file, parse the YAML frontmatter to extract: title, priority, status, created, expires, tags.
Check for expired todos: if expires < today and status is unclaimed, mark as expired.
If $ARGUMENTS is provided, filter to that status. Default: show all.
Format as a table sorted by priority (high first), then age (oldest first):
| Status | Priority | Title | Created | Expires | Tags |
| --------- | -------- | ---------------------------------- | ---------- | ---------- | ------------- |
| unclaimed | high | Fix broken import in utils.ts | 2026-03-20 | 2026-04-19 | cleanup |
| unclaimed | low | Remove stale foobar alias | 2026-03-23 | 2026-04-22 | cleanup, zsh |
| blocked | medium | Add missing test for parser | 2026-03-15 | 2026-04-14 | tests |
Include a summary line: "3 todos (2 unclaimed, 1 blocked, 0 expired)"
npx claudepluginhub bestdan/todo-plugin --plugin todo/list-todosLists pending todos from STATE.md with action hints for resolution. Supports optional priority filter (e.g., high, medium). Requires VBW initialization and Bash access.