openclaw/remindctl

Registry

Summary

remindctl is a Swift-based command-line interface for Apple Reminders, enabling users to create, list, complete, and delete reminders directly from the terminal.

Key features

• Create reminders with titles, notes, due dates, and priority
• List reminders by list, date, or completion status
• Mark reminders as completed or delete them
• Supports multiple Apple Reminders accounts and lists
• Lightweight and fast terminal-based workflow

Use cases

• Automate reminder management in scripts or cron jobs
• Quickly add reminders without opening the Reminders app
• Batch complete or delete old reminders
• Integrate with other CLI tools for task management

README excerpt

# remindctl  Fast command-line access to Apple Reminders on macOS. `remindctl` is for scripts, agents, and terminal workflows that need to read and update the same reminders you see in Reminders.app. It uses Apple's public EventKit APIs, so reminders keep syncing through the normal system/iCloud path. Docs: https://remindctl.sh ## Install ### Homebrew ```bash brew install steipete/tap/remindctl ``` ### From Source ```bash pnpm install pnpm build # binary at ./bin/remindctl ``` ## Requirements - macOS 14+ (Sonoma or later) - Swift 6.2+ when building from source - Full Reminders access for the terminal app that runs `remindctl` ## Quick Start ```bash remindctl add "Buy milk" remindctl add "Call mom" --list Personal --due tomorrow remindctl add "Meeting" --due "2026-01-03 09:00" --alarm "2026-01-03 08:55" remindctl add "Buy headphones" --url "https://example.com/product" remindctl today remindctl overdue remindctl open remindctl list Work Errands remindctl list --list-id 7A12 remindctl search "milk" remindctl info 1 remindctl doctor --for-agent remindctl export --list Work --export-format csv remindctl link 1 remindctl edit 1 --title "New title" --due 2026-01-04 remindctl edit 1 --url "https://example.com/product" # or --clear-url to remove it remindctl complete 1 2 3 remindctl delete 4A83 --force ``` Indexes such as `1` come from the default reminder listing. Most commands also accept an ID prefix such as `4A83`. ## Commands | Command | Purpose | | --- | --- | | `remindctl` / `remindctl today` | Show today's reminders | | `remindctl show <filter>` | Show reminders by filter or date | | `remindctl search <query>` | Search incomplete reminder titles, notes, and URLs | | `remindctl info <id>` | Show detail

Topics

No topics yet.