suidge-todo-tracker（Suidge 待办事项追踪器）

Setup

On first use, copy templates/todo.json to memory/todo.json. Update HEARTBEAT.md and AGENTS.md with trigger rules. See setup.md for details.

When to Use

User mentions reminders, follow-ups, or todos. Agent proactively checks pending items during heartbeat cycles.

Quick Reference

Core Rules

🚨 HARD CONSTRAINTS (Must Follow)

When marking a todo as completed or cancelled, you MUST set the corresponding timestamp field:

• status=completed → MUST set completed_at to current time (ISO 8601 with timezone)
• status=cancelled → MUST set cancelled_at to current time (ISO 8601 with timezone)

Example:

{
  "status": "completed",
  "completed_at": "2026-04-16T13:40:00+08:00"  // ← REQUIRED!
}

Failure to set these fields will cause cleanup script to skip the item, leaving completed tasks in todo.json indefinitely.

Why this matters: The cleanup script (scripts/todo-cleaner.py) checks completed_at to determine if an item is older than 24 hours. Without this field, completed items will never be deleted.

1. Store Items in memory/todo.json

Single source of truth. Each item has: id, description, follow_up_time, status, priority, context.

2. Check During Heartbeat

Every heartbeat (30 min), check status=pending items. If follow_up_time reached, remind user (regardless of reminded flag — pending items should be reminded repeatedly until completed).

3. Clean Up Completed Items

Items with status=completed or status=cancelled are deleted after 24 hours.

Cleanup Script: Run scripts/todo-cleaner.py to auto-delete old completed items.

# Dry run (preview)
python3 ~/.openclaw/workspace/skills/todo-tracker/scripts/todo-cleaner.py --dry-run

# Execute cleanup
python3 ~/.openclaw/workspace/skills/todo-tracker/scripts/todo-cleaner.py

4. Time Precision is ~30 Minutes

Reminders trigger at heartbeat intervals, not exact times. Plan accordingly.

5. Prevent Duplicate Reminders

Set reminded=true after reminding. Check this flag before reminding again.

6. Ask for Missing Info

If user says "remind me tomorrow" without specifics, ask: "What time tomorrow?"

Trigger Keywords

Data Storage

memory/todo.json — all todo items. See data-structure.md for schema.

Feedback

• If useful: clawhub star suidge-todo-tracker
• Issues: Report via GitHub

slug: suidge-todo-tracker homepage: https://github.com/Suidge/todo-tracker