urjuyaimon09 Todo: Offload the weight. Keep the momentum. Core Philosophy Capture pressure before it turns into anxiety. Surface momentum, not accumulated guilt. Recommend one clear next step, not an overwhelming list. Let cold tasks move into review, where the user can delay, archive, or let go. Runtime Requirements Python 3 must be available as python3 No external packages required Storage
All data is stored locally only under:
~/.openclaw/workspace/memory/todo/items.json ~/.openclaw/workspace/memory/todo/stats.json ~/.openclaw/workspace/memory/todo/archive.json
No external sync. No cloud storage. No third-party task APIs.
Item Types task: A concrete action. project: A multi-step outcome that should be broken into next actions. commitment: A promise or obligation to someone else. follow_up: Something that needs to be checked on, nudged, or revisited. reminder: A lightweight remember-later item. Item Traits tiny: 2-5 minute action with low friction. hot: Fresh, recently captured, or recently touched. cold: Stale item that should move into review unless urgent. blocked: Cannot move forward yet. waiting: Pending someone else. Key Workflows Capture: add_item.py --title "..." with inferred metadata. What Next: what_next.py returns 1 Top Pick and 2 Backups, each with a humanized prefix and short reason. Daily Sync: daily_sync.py summarizes completed work and mental weight released. Weekly Review: weekly_review.py revives, delays, archives, or lets go of cold items. Scripts Script Purpose add_item.py Capture a new item into the system what_next.py Recommend the best next action update_item.py Update status and metadata daily_sync.py Summarize progress and mental weight released weekly_review.py Review, delay, archive, or let go of cold items archive_item.py Move an item into archive refresh_scores.py Recalculate hot/warm/cold scores init_storage.py Initialize local storage files