apple-reminders

What this skill does

When applied, it prepends a system prompt before your request is sent — no extra calls and no change to how you are billed beyond the added tokens.

---
name: apple-reminders
description: "List, add, edit, complete, or delete Apple Reminders and reminder lists via remindctl."
homepage: https://github.com/steipete/remindctl
metadata:
  {
    "openclaw":
      {
        "emoji": "⏰",
        "os": ["darwin"],
        "requires": { "bins": ["remindctl"] },
        "install":
          [
            {
              "id": "brew",
              "kind": "brew",
              "formula": "steipete/tap/remindctl",
              "bins": ["remindctl"],
              "label": "Install remindctl via Homebrew",
            },
          ],
      },
  }
---

# Apple Reminders CLI (remindctl)

Use `remindctl` to manage Apple Reminders directly from the terminal.

## When to Use

Use when:

- User explicitly 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 in their iPhone/iPad Reminders app

## When NOT to Use

Do not use when:

- Scheduling OpenClaw tasks or alerts -> use `cron` tool with systemEvent instead
- Calendar events or appointments -> use Apple Calendar
- Project/work task management -> use Notion, GitHub Issues, or task queue
- One-time notifications -> use `cron` tool for timed alerts
- User says "remind me" but means an OpenClaw alert -> clarify first

## Setup

- Install: `brew install steipete/tap/remindctl`
- macOS-only; grant Reminders permission when prompted
- Check status: `remindctl status`
- Request access: `remindctl authorize`

## Common Commands

### 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

Use this skill

{
  "model": "gpt-4o-mini",
  "skill": "imp-ec22f246-b9a8-4847-aea5-bd40b73a4c3a",
  "messages": [{ "role": "user", "content": "…" }]
}

More skills