🎁 Get the FREE AI Skills Starter Guide β€” Subscribe β†’
BytesAgainBytesAgain
πŸ¦€ ClawHub

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....

Versionv1.0.6
Installs4
πŸ’‘ Examples

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 priority
  • 1 = 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" 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 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 today
    

    πŸ“‹ Tips & Best Practices

    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

    View on ClawHub
    TERMINAL
    clawhub install todolist

    πŸ§ͺ Use this skill with your agent

    Most visitors already have an agent. Pick your environment, install or copy the workflow, then run the smoke-test prompt above.

    πŸ” Can't find the right skill?

    Search 60,000+ AI agent skills β€” free, no login needed.

    Search Skills β†’