openclaw/remindctl
openclaw/remindctl
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases 3 Wiki Activity
d8f9510112
remindctl/README.md
Peter Steinberger d8f9510112 feat: initial remindctl cli
2026-01-03 07:14:56 +01:00

1.6 KiB
Raw Blame History

remindctl

Fast CLI for Apple Reminders on macOS.

Install

Homebrew (Home Pro)

brew install steipete/tap/remindctl

From source

pnpm install
pnpm build
# binary at ./bin/remindctl

Requirements

  • macOS 14+ (Sonoma or later)
  • Swift 6.2+
  • Reminders permission (System Settings → Privacy & Security → Reminders)

Usage

remindctl                      # show today (default)
remindctl today                 # show today
remindctl tomorrow              # show tomorrow
remindctl week                  # show this week
remindctl overdue               # overdue
remindctl upcoming              # upcoming
remindctl completed             # completed
remindctl all                   # all reminders
remindctl 2026-01-03            # specific date

remindctl list                  # lists
remindctl list Work             # show list
remindctl list Work --rename Office
remindctl list Work --delete
remindctl list Projects --create

remindctl add "Buy milk"
remindctl add --title "Call mom" --list Personal --due tomorrow
remindctl edit 1 --title "New title" --due 2026-01-04
remindctl complete 1 2 3
remindctl delete 4A83 --force

Output formats

  • --json emits JSON arrays/objects.
  • --plain emits tab-separated lines.
  • --quiet emits counts only.

Date formats

Accepted by --due and filters:

  • today, tomorrow, yesterday
  • YYYY-MM-DD
  • YYYY-MM-DD HH:mm
  • ISO 8601 (2026-01-03T12:34:56Z)

Permissions

On first run, macOS will prompt for Reminders access. You can manage access in: System Settings → Privacy & Security → Reminders.