Npjames 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

This skill is an instruction-only wrapper around the macOS remindctl CLI and its requirements and install steps generally match the stated purpose, though there are minor metadata inconsistencies worth checking.

Purpose & Capability

The name/description align with the declared requirement for the remindctl binary and Homebrew formula. However, there are minor metadata inconsistencies: the registry metadata owner id (kn7aj94...) differs from the _meta.json ownerId (kn70py...), and the SKILL.md uses the name 'apple-reminders' while the published skill is labelled 'Npjames Apple Reminders' — these are not security-critical but reduce provenance confidence.

Instruction Scope

SKILL.md contains only step-by-step instructions to install and run remindctl and to grant macOS Reminders permission. It does not instruct reading unrelated files, exfiltrating data, or accessing environment variables. One minor note: the 'From source' build instructions reference pnpm/node tooling (pnpm install && pnpm build) even though pnpm/node are not declared in requirements — this is a reasonable optional alternative but not documented in the metadata.

Install Mechanism

Install spec uses a Homebrew formula (steipete/tap/remindctl), which is a typical and low-risk distribution channel. There are no raw URL downloads, extract steps, or obscure hosts in the install spec.

Credentials

No environment variables, credentials, or config paths are requested, which is proportionate for a CLI wrapper that acts on the local Reminders database via the OS permission model.

Persistence & Privilege

Skill is not marked always:true and does not request elevated platform presence or modify other skills' configs. It relies on the user granting macOS Reminders permission to the binary, which is normal for this functionality.

Assessment

This skill appears to do exactly what it says: call the remindctl CLI to manage macOS Reminders. Before installing, verify the Homebrew formula and GitHub repo (steipete/tap/remindctl) are the expected upstream project, and prefer installing the formula yourself so you can inspect it (brew edit/formula or check the tap repo). Be aware that granting remindctl access in System Settings gives the binary access to your Reminders data on that Mac. The only small concerns are metadata mismatches (ownerId/name) — these look like provenance/packaging inconsistencies rather than malicious behavior; if provenance matters to you, confirm the publisher identity on the registry or the tap repo prior to use.

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.