next-todo

/next-todo

Triggers

Use this command when the user says any of: "next-todo", "next todo", "what's next", "what's my next task", "what should I work on", "what should I do now", "what's most important", "what's at the top of my list", "most urgent task", "highest priority", "what's pressing", "what's due", "what's overdue", "anything urgent", "what's first on my list", "top priority", "what's critical right now"

Priority order

1. Overdue items — oldest due date first
2. High priority with an upcoming due date
3. High priority, no due date
4. Med priority

What to do

Read URL:

URL=$(cat ~/.config/todo-mcp/url 2>/dev/null || echo "")
[ -z "$URL" ] && echo "Run /setup-todo first" && exit 1

Fetch open todos (MCP direct if available, else curl):

curl -s -N -X POST "$URL/mcp" \
  -H "Content-Type: application/json" \
  -H "Accept: application/json, text/event-stream" \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"todo_list","arguments":{"params":{"done":false}}}}' \
  | grep '^data:' | python3 -c "
import sys,json
d=json.loads(sys.stdin.read()[5:])
for c in d.get('result',{}).get('content',[]):
    if c.get('type')=='text': print(c['text'])"

Pick the single top item per priority order. Present it as:

Next up [ID]: <text>
Priority: high  |  Tag: work  |  Due: 2026-04-01 (OVERDUE)

Offer two follow-ups:

• Mark as done: tell user to say "mark [ID] done"
• See full list: tell user to say "/list-todo"

Examples

/next-todo
what's next on my list?
what should I work on today?
anything overdue?