Apple Reminders

Manage Apple Reminders via the `remindctl` CLI on macOS (list, add, edit, complete, delete). Supports lists, date filters, and JSON/plain output.

Security Scan

The skill is internally consistent: it just documents usage of the remindctl CLI to manage macOS Reminders, asks for no unrelated credentials, and its instructions match its stated purpose.

Purpose & Capability

Name/description match the instructions: all actions are remindctl CLI operations for Apple Reminders on macOS. No unrelated binaries, env vars, or credentials are requested.

Instruction Scope

SKILL.md tells the agent to run remindctl (and optionally build or install it). It only references macOS Reminders permission (a local privacy grant). The instructions do not ask the agent to read unrelated files, access external credentials, or exfiltrate data.

Install Mechanism

Registry lists this as instruction-only (no install spec), but SKILL.md includes metadata recommending Homebrew (steipete/tap/remindctl) and a from-source pnpm build. Homebrew tap and GitHub repo are reasonable sources; building from source uses pnpm (network access). Verify the tap/repo before installing.

Credentials

No environment variables or external API keys requested. The only permission is the expected macOS Reminders privacy grant for the remindctl binary; that local permission is proportional to the functionality.

Persistence & Privilege

always is false and the skill is user-invocable. It does not request persistent system-wide changes or access to other skills' configs. Autonomous invocation is allowed by default (normal) but not excessive here.

Scan Findings in Context

[no_regex_findings] expected: The repository/skill contains no code files; the regex-based scanner had nothing to analyze. This is expected for an instruction-only skill that delegates work to an external CLI.

Assessment

This skill is a wrapper for the remindctl CLI on macOS and is coherent with its description. Before installing/use: (1) ensure you run it on macOS and have or will install the remindctl binary (Homebrew formula steipete/tap/remindctl or build via pnpm); (2) verify the Homebrew tap / GitHub repo (steipete/remindctl) if you plan to install binaries; (3) be aware the binary will request macOS Reminders permission — only grant that to terminals/processes you trust (especially when using SSH); and (4) note the skill is instruction-only so the agent will attempt to run local commands — only enable/use it if you trust the agent to execute those operations.

Apple Reminders CLI (remindctl)

Use remindctl to manage Apple Reminders directly from the terminal. It supports list filtering, date-based views, and scripting output.

Setup

• Install (Homebrew): brew install steipete/tap/remindctl
• From source: pnpm install && pnpm build (binary at ./bin/remindctl)
• macOS-only; grant Reminders permission when prompted.

Permissions

• Check status: remindctl status
• Request access: remindctl authorize

View Reminders

• Default (today): remindctl
• Today: remindctl today
• Tomorrow: remindctl tomorrow
• Week: remindctl week
• Overdue: remindctl overdue
• Upcoming: remindctl upcoming
• Completed: remindctl completed
• All: remindctl all
• Specific date: remindctl 2026-01-04

Manage Lists

• List all lists: remindctl list
• Show list: remindctl list Work
• Create list: remindctl list Projects --create
• Rename list: remindctl list Work --rename Office
• Delete list: remindctl list Work --delete

Create Reminders

• Quick add: remindctl add "Buy milk"
• With list + due: remindctl add --title "Call mom" --list Personal --due tomorrow

Edit Reminders

• Edit title/due: remindctl edit 1 --title "New title" --due 2026-01-04

Complete Reminders

• Complete by id: remindctl complete 1 2 3

Delete Reminders

• Delete by id: remindctl delete 4A83 --force

Output Formats

• JSON (scripting): remindctl today --json
• Plain TSV: remindctl today --plain
• Counts only: remindctl today --quiet

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)

Notes

• macOS-only.
• If access is denied, enable Terminal/remindctl in System Settings → Privacy & Security → Reminders.
• If running over SSH, grant access on the Mac that runs the command.