remindctl
github.com/openclaw/remindctl- Category
- Productivity
- Rank
- No. 1320Tools index
Previous survey · No. 1328 ·
- Pricing
- Open Source
- Type
- TOOL
- Builder
- openclaw
- GitHub
- 357 stars
- Latest release
- v0.3.6
- Date
About
OpenClaw's CLI for the Apple Reminders app — add, list, complete reminders from the terminal across iCloud-synced lists.
What it does
remindctl gives scripts and local agents structured access to the reminders already managed by macOS. It reads and changes data through Apple’s public EventKit framework, preserving the normal system and iCloud sync path. Commands cover filtering, search, list management, dates, alarms, recurrence, priorities, notes, URLs, location triggers, export, and diagnostics.
Why it's ranked here
This is a strong pick for automating an existing Apple Reminders workflow. JSON and stable tab-separated output support scripts, while explicit list IDs reduce ambiguity. Permission diagnostics and noninteractive operation address agent use directly. The narrow macOS scope is justified by native EventKit integration, though that same choice limits feature coverage.
What's good
The interface serves both people and automation: compact output, tables, JSON, stable tab-separated records, quiet mode, and disabled prompts are all supported. Date-only and timed reminders remain distinct. Alarm edits preserve relative and location-based alarms when replacing absolute alarms. Search returns stable IDs, and ambiguous list names can be replaced with exact identifiers.
Tradeoffs
It requires macOS 14 or later and full Reminders permission for the terminal host. Remote use still needs permission granted on the Mac executing commands. Public EventKit cannot expose native sections, tags, smart lists, attachments, or Apple’s private Urgent control. Location triggers also depend on system location services and may require network access.
How to use it well
Use it for shell scripts, local agents, and terminal routines that treat Apple Reminders as a shared task store. Prefer JSON or tab-separated output in automation, exact list identifiers when names collide, and noninteractive mode in unattended runs. Keep another tool for workflows requiring attachments, native tags, smart lists, sections, or cross-platform execution.
Technical notes+
Package.swift defines a Swift 6 package for macOS 14 with a RemindCore library, a remindctl executable, two test targets, EventKit and CoreLocation linkage, and Commander as the executable dependency. package.json and Makefile wrap version synchronization, Swift builds, linting, tests, coverage enforcement, documentation generation, and release checks. README.md documents Homebrew and source installation. docs/RELEASING.md describes universal arm64 and x86_64 artifacts, Developer ID signing, notarization, native verification, clean-VM Gatekeeper checks, and guarded Homebrew publication. Sources/RemindCore/Models.swift contains Codable, Sendable reminder models, while Sources/RemindCore/Errors.swift provides permission, lookup, date, and operation errors.
Observed
- License
- MIT
- Implementation
- Swift 6 package
- Interfaces
- Command-line executable and Swift library product
- Platform
- macOS 14 or later
- Installation
- Homebrew tap or source build with pnpm and Swift Package Manager
- System frameworks
- EventKit and CoreLocation
- Test structure
- Two Swift test targets are declared
Read from README.md, Makefile, package.json, docs/index.md, docs/install.md, docs/commands.md, docs/RELEASING.md, docs/permissions.md, docs/manual-tests.md, Package.swift, scripts/build-docs-site.mjs, Sources/RemindCore/Errors.swift, Sources/RemindCore/Models.swift, Sources/remindctl/Console.swift, Sources/remindctl/Version.swift.
What it can do
Add reminders to Apple Reminders app
Reminder text and target list name → New reminder created in specified iCloud-synced list
List existing reminders
List name or search criteria → Display of reminders from specified lists
Mark reminders as complete
Reminder identifier or selection criteria → Updated reminder status marked as completed
Access iCloud-synced reminder lists
Apple ID credentials and list permissions → Connection to synced reminder data across devices
Manage reminders via command line interface
Terminal commands with reminder operations → Executed reminder actions without GUI interaction
Tags
Tech Stack
Comments (0)
No comments yet
Editorially curated, with community endorsements as a secondary signal. Corrections welcome.