f210510276
Skills can now declare runtime prerequisites (env vars, CLI binaries) via YAML frontmatter. Skills with unmet prerequisites are excluded from the system prompt so the agent never claims capabilities it can't deliver, and skill_view() warns the agent about what's missing. Three layers of defense: - build_skills_system_prompt() filters out unavailable skills - _find_all_skills() flags unmet prerequisites in metadata - skill_view() returns prerequisites_warning with actionable details Tagged 12 bundled skills that have hard runtime dependencies: gif-search (TENOR_API_KEY), notion (NOTION_API_KEY), himalaya, imessage, apple-notes, apple-reminders, openhue, duckduckgo-search, codebase-inspection, blogwatcher, songsee, mcporter. Closes #658 Fixes #630
98 lines
2.5 KiB
Markdown
98 lines
2.5 KiB
Markdown
---
|
|
name: apple-reminders
|
|
description: Manage Apple Reminders via remindctl CLI (list, add, complete, delete).
|
|
version: 1.0.0
|
|
author: Hermes Agent
|
|
license: MIT
|
|
platforms: [macos]
|
|
metadata:
|
|
hermes:
|
|
tags: [Reminders, tasks, todo, macOS, Apple]
|
|
prerequisites:
|
|
commands: [remindctl]
|
|
---
|
|
|
|
# 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: `remindctl status` / Request: `remindctl 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
|
|
|
|
```bash
|
|
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
|
|
|
|
```bash
|
|
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
|
|
|
|
```bash
|
|
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
|
|
|
|
```bash
|
|
remindctl complete 1 2 3 # Complete by ID
|
|
remindctl delete 4A83 --force # Delete by ID
|
|
```
|
|
|
|
### Output Formats
|
|
|
|
```bash
|
|
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`, `tomorrow`, `yesterday`
|
|
- `YYYY-MM-DD`
|
|
- `YYYY-MM-DD HH:mm`
|
|
- ISO 8601 (`2026-01-04T12:34:56Z`)
|
|
|
|
## Rules
|
|
|
|
1. When user says "remind me", clarify: Apple Reminders (syncs to phone) vs agent cronjob alert
|
|
2. Always confirm reminder content and due date before creating
|
|
3. Use `--json` for programmatic parsing
|