Hermes-agent apple-reminders
Manage Apple Reminders via remindctl CLI (list, add, complete, delete).
install
source · Clone the upstream repo
git clone https://github.com/NousResearch/hermes-agent
Claude Code · Install into ~/.claude/skills/
T=$(mktemp -d) && git clone --depth=1 https://github.com/NousResearch/hermes-agent "$T" && mkdir -p ~/.claude/skills && cp -r "$T/skills/apple/apple-reminders" ~/.claude/skills/nousresearch-hermes-agent-apple-reminders-e88f47 && rm -rf "$T"
manifest:
skills/apple/apple-reminders/SKILL.mdsource content
Apple Reminders
Use
remindctl to manage Apple Reminders directly from the terminal. Tasks sync across all Apple devices via iCloud.
Prerequisites
- macOS with Reminders.app
- Install:
brew install steipete/tap/remindctl - Grant Reminders permission when prompted
- Check:
/ Request:remindctl statusremindctl authorize
When to Use
- User mentions "reminder" or "Reminders app"
- Creating personal to-dos with due dates that sync to iOS
- Managing Apple Reminders lists
- User wants tasks to appear on their iPhone/iPad
When NOT to Use
- Scheduling agent alerts → use the cronjob tool instead
- Calendar events → use Apple Calendar or Google Calendar
- Project task management → use GitHub Issues, Notion, etc.
- If user says "remind me" but means an agent alert → clarify first
Quick Reference
View Reminders
remindctl # Today's reminders remindctl today # Today remindctl tomorrow # Tomorrow remindctl week # This week remindctl overdue # Past due remindctl all # Everything remindctl 2026-01-04 # Specific date
Manage Lists
remindctl list # List all lists remindctl list Work # Show specific list remindctl list Projects --create # Create list remindctl list Work --delete # Delete list
Create Reminders
remindctl add "Buy milk" remindctl add --title "Call mom" --list Personal --due tomorrow remindctl add --title "Meeting prep" --due "2026-02-15 09:00"
Complete / Delete
remindctl complete 1 2 3 # Complete by ID remindctl delete 4A83 --force # Delete by ID
Output Formats
remindctl today --json # JSON for scripting remindctl today --plain # TSV format remindctl today --quiet # Counts only
Date Formats
Accepted by
--due and date filters:
,today
,tomorrowyesterdayYYYY-MM-DDYYYY-MM-DD HH:mm- ISO 8601 (
)2026-01-04T12:34:56Z
Rules
- When user says "remind me", clarify: Apple Reminders (syncs to phone) vs agent cronjob alert
- Always confirm reminder content and due date before creating
- Use
for programmatic parsing--json