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.pyreturns 1 Top Pick and 2 Backups, each with a humanized prefix and short reason. - Daily Sync:
daily_sync.pysummarizes completed work and mental weight released. - Weekly Review:
weekly_review.pyrevives, 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 |