Manage todo checklists organized by facet and day. List, add, complete, cancel, and move tasks and action items. Review upcoming scheduled items. Use when the owner mentions tasks, to-do items, action items, checklists, or reminders, or asks to add, complete, cancel, or review todos. TRIGGER: todo, task, action item, checklist, reminder, upcoming items.
Use these commands to manage checklist entries from the terminal.
Environment defaults: When SOL_DAY is set, commands that take a DAY argument will use it automatically. Same for SOL_FACET where FACET is required.
Common pattern:
sol call todos <command> [args...]
sol call todos list [DAY] [-f FACET] [--to DAY]
Show checklist entries for one day or an inclusive day range.
DAY: day in YYYYMMDD (default: SOL_DAY env).-f, --facet: optional facet filter. Omit to show all facets.--to: optional inclusive range end day in .YYYYMMDDBehavior notes:
--to is set and differs from DAY, output is grouped by day headers.Examples:
sol call todos list 20260115 -f work
sol call todos list 20260101 --to 20260107 -f work
sol call todos list 20260115
sol call todos add TEXT [-d DAY] [-f FACET] [--force]
Add a new todo item.
TEXT: todo text (positional argument).-d, --day: day in YYYYMMDD (default: SOL_DAY env).-f, --facet: facet name (default: SOL_FACET env).Behavior notes:
(HH:MM) suffix.upcoming first to avoid duplicates already scheduled on other days.--force to override.Examples:
sol call todos add "Draft Q1 plan" -d 20260115 -f work
sol call todos add "Team sync prep (14:30)" -d 20260115 -f work
sol call todos done LINE_NUMBER [-d DAY] [-f FACET]
Mark a todo as complete.
LINE_NUMBER: 1-based line number from list output (positional argument).-d, --day: day in YYYYMMDD (default: SOL_DAY env).-f, --facet: facet name (default: SOL_FACET env).Example:
sol call todos done 2 -d 20260115 -f work
sol call todos cancel LINE_NUMBER [-d DAY] [-f FACET]
Cancel (soft-delete) a todo.
LINE_NUMBER: 1-based line number from list output (positional argument).-d, --day: day in YYYYMMDD (default: SOL_DAY env).-f, --facet: facet name (default: SOL_FACET env).Behavior notes:
Example:
sol call todos cancel 4 -d 20260115 -f work
sol call todos upcoming [-l LIMIT] [-f FACET]
Show future todos grouped by facet and day.
-l, --limit: max items (default 20).-f, --facet: optional facet filter. Omit to include all facets.Behavior notes:
Examples:
sol call todos upcoming
sol call todos upcoming -l 50 -f work
sol call todos move LINE_NUMBER --day DAY --from SOURCE --to DEST [--consent]
Move an open todo from one facet to another.
LINE_NUMBER: 1-based line number from list output (positional argument).--day: day in YYYYMMDD (required).--from: source facet name.--to: destination facet name.--consent: required when called by a proactive agent.Example:
sol call todos move 3 --day 20260115 --from personal --to work --consent