reminders

---
name: reminders
description: "Use when working with apple Reminders via rem CLI: add, list, search, update, complete, delete from steipete/agent-scripts."
source: https://github.com/steipete/agent-scripts/tree/main/skills/reminders
generated: 2026-05-27T20:56:24.905Z
category: tool
audience: general
---

## When to use

- Apple Reminders tasks. Prefer rem over Things/AppleScript when the user wants an AI-friendly personal todo backend on macOS.
- Using the reminders skill's upstream workflow, guardrails, and local-tool assumptions.
- Auditing commands or operational steps before changing reminders behavior.
- Needing a compact agent reference for apple Reminders via rem CLI: add, list, search, update, complete, delete.

## Key concepts

### Start

Check access: Use JSON for anything scripted or verified:.

### Add Tasks

Default: add directly, then verify by search/show. Useful flags: --list "Name": target list --due "tomorrow 9am": due date/time; natural language is supported --priority high|medium|low|none --notes "text" --url https://... --silent: due date without notification --remind-me 15m: alarm before due time --repeat daily|weekly|monthly|yearly.

### Update / Complete / Delete

Find the UUID first, then mutate by id or unique short id: Always read back after writes; do not trust exit status alone.

### Lists

Lists guidance for the reminders skill.

### Conventions

Use executable task titles. Rewrite vague notes into the next concrete action. Preserve user wording when they clearly want verbatim capture. Split multiple unrelated actions into separate reminders. Use the default list unless the user names a list or the category is obvious. Do not add calendar events here; use calendar tooling instead. For current date math, run date; do not guess.

### Gotchas

macOS only. First run may fail with reminders access denied until the calling app has Reminders permission. The default local list may be localized, e.g. Erinnerungen. rem search is plain query search, not shell regex. --due creates an alarm at the due time unless --silent is passed. Flagged reminders use private ReminderKit under the hood and may be more OS fragile than ordinary CRUD.

## API reference

```
npx skills add steipete/agent-scripts --skill reminders
```

Install the reminders skill from steipete/agent-scripts.

```
npx skills add steipete/agent-scripts --skill reminders
```

```
GOBIN=/opt/homebrew/bin go install github.com/BRO3886/rem/cmd/rem@latest.
```

Command or snippet documented by the upstream reminders skill.

```
GOBIN=/opt/homebrew/bin go install github.com/BRO3886/rem/cmd/rem@latest
```

```
rem lists -o json.
```

Command or snippet documented by the upstream reminders skill.

```
rem lists -o json
rem today -o json
```

```
rem list --incomplete -o json.
```

Command or snippet documented by the upstream reminders skill.

```
rem list --incomplete -o json
rem search "flight" -o json
rem show <id> -o json
```

```
rem add "Book LHR-SFO nonstop business flight" --due "tomorrow 9am" --priority high --notes "Nonstop only." -o json.
```

Command or snippet documented by the upstream reminders skill.

```
rem add "Book LHR-SFO nonstop business flight" --due "tomorrow 9am" --priority high --notes "Nonstop only." -o json
rem search "LHR-SFO" -o json
```

```
rem search "flight" -o json.
```

Command or snippet documented by the upstream reminders skill.

```
rem search "flight" -o json
rem update <id> --name "New title" --due "friday 2pm" --notes "..." -o json
rem complete <id> -o json
rem delete <id> --force
```

```
rem lists --count -o json.
```

Command or snippet documented by the upstream reminders skill.

```
rem lists --count -o json
rem list-mgmt create "Travel"
rem list-mgmt rename "Old" "New"
rem list-mgmt delete "Name" --force
```

## Gotchas

- Always read back after writes; do not trust exit status alone.
- Do not add calendar events here; use calendar tooling instead.

---
Generated by SkillMake from https://github.com/steipete/agent-scripts/tree/main/skills/reminders on 2026-05-27T20:56:24.905Z.
Verify against source before relying on details.

File: ~/.claude/skills/reminders/SKILL.md