- name
- todo
- description
- |
To Do List (Mac)
⚠️ System Requirements
This skill is macOS-only, requiring the native Reminders app. It will not work on non-Mac systems.
Feature Overview
This skill bridges macOS Reminders via AppleScript, supporting full reminder lifecycle management:
| Feature | Command |
|---|---|
| Add reminder | todo add |
| List reminders | todo list |
| Mark complete | todo complete |
| Unmark complete | todo uncomplete |
| Delete reminder | todo delete |
| Search reminders | todo search |
| View lists | todo lists |
| Create list | todo create-list |
| Today's reminders | todo today |
Usage
All operations are executed via the scripts/todo.sh script:
./scripts/todo.sh <action> [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 list
# List from specific list
./scripts/todo.sh list "Shopping"
# Include completed reminders
./scripts/todo.sh list "" true
# List all from specific list (including completed)
./scripts/todo.sh list "Work" true3. 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 lists
# Create new list
./scripts/todo.sh create-list "Study Plan"7. Today's Due Reminders
# View today's incomplete due reminders
./scripts/todo.sh todayFull Example Workflow
# 1. Create a work list
./scripts/todo.sh create-list "Work"
# 2. Add work tasks
./scripts/todo.sh add "Finish Q4 report" "Compile data" "2025-02-05 17:00" "Work" 1 ""
./scripts/todo.sh add "Reply to client email" "" "" "Work" 5 ""
./scripts/todo.sh add "Team weekly" "Prepare slides" "2025-02-06 10:00" "Work" 1 ""
# 3. View work list
./scripts/todo.sh list "Work"
# 4. Complete a task
./scripts/todo.sh complete "Reply to client email"
# 5. Check today's todos
./scripts/todo.sh todayUser Interaction Tips
When users want to manage todos:
- Clarify intent - Ask what they want to do (add, view, complete, etc.)
- Offer shortcuts - For common actions like "remind me to...", directly call add
- Show results - Display operation results and current list status
- Support fuzzy matching - complete/delete/search all support fuzzy matching
Notes
- Date format - Supports natural formats like "2025-02-05", "Feb 5, 2025", "tomorrow"
- Fuzzy matching - complete/delete/search use contains matching, no need for full titles
- Permissions - macOS may request permission to control Reminders on first run, click Allow
- Sync - Changes sync to iCloud and appear on other Apple devices
- Recurring reminders - Due to AppleScript limitations, complex recurring settings should be configured manually in the app