Todo List for MacOS
by @manifoldor
**macOS Only** - Manage macOS Reminders app via AppleScript. Full-featured reminder management: add, list, complete, delete, search, create lists, and more....
All operations are executed via the scripts/todo.sh script:
./scripts/todo.sh [args...]
1. Add Reminder
# Basic usage
./scripts/todo.sh add "title" "notes" "date" "list" "priority" "recur"Example: Simple reminder
./scripts/todo.sh add "Buy milk" "" "" "" 0 ""Example: With due date
./scripts/todo.sh add "Submit report" "Q4 summary" "2025-02-10 14:00" "" 1 ""Example: Add to specific list
./scripts/todo.sh add "Buy eggs" "Buy 12" "" "Shopping" 5 ""Example: High priority + list + date
./scripts/todo.sh add "Important meeting" "Client call" "2025-02-05 10:00" "Work" 1 ""
Priority levels:
0 = No priority1 = High (π΄)5 = Medium (π‘)9 = Low (π΅)2. List Reminders
# List incomplete reminders from default list
./scripts/todo.sh listList from specific list
./scripts/todo.sh list "Shopping"Include completed reminders
./scripts/todo.sh list "" trueList all from specific list (including completed)
./scripts/todo.sh list "Work" true
3. Mark Complete/Uncomplete
# Mark complete (supports fuzzy matching)
./scripts/todo.sh complete "Buy milk"Unmark complete
./scripts/todo.sh uncomplete "Buy milk"
4. Delete Reminder
# Delete reminder (supports fuzzy matching)
./scripts/todo.sh delete "Buy milk"
β οΈ Deletion is irreversible. Use with caution.
5. Search Reminders
# Search by keyword in title or content
./scripts/todo.sh search "meeting"
6. Manage Lists
# View all lists with stats
./scripts/todo.sh listsCreate new list
./scripts/todo.sh create-list "Study Plan"
7. Today's Due Reminders
# View today's incomplete due reminders
./scripts/todo.sh today
1. Date format - Supports natural formats like "2025-02-05", "Feb 5, 2025", "tomorrow" 2. Fuzzy matching - complete/delete/search use contains matching, no need for full titles 3. Permissions - macOS may request permission to control Reminders on first run, click Allow 4. Sync - Changes sync to iCloud and appear on other Apple devices 5. Recurring reminders - Due to AppleScript limitations, complex recurring settings should be configured manually in the app
clawhub install todolist