apple-reminders

Manage Apple Reminders in the Assistant list via remindctl wrapper.

Updated Feb 1, 2026
One-click install
npx skills add https://github.com/hvent90/assistant --skill apple-reminders-hvent90
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: apple-reminders
Source: https://github.com/hvent90/assistant/tree/main/.agent/skills/apple-reminders
Command: npx skills add https://github.com/hvent90/assistant --skill apple-reminders-hvent90

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This skill provides a safe, reliable way to manage Apple Reminders by routing remindctl calls through a dedicated macOS-permissioned wrapper, avoiding permission issues for background processes.

Core Features & Use Cases

  • Manage a dedicated Assistant list for reminders: show, add, edit, complete, and delete items without affecting other lists.
  • Operate from the agent context on macOS, with heartbeat checks to surface due reminders to the user.
  • Use the included remindctl-wrapper.sh to perform all operations, ensuring proper permissions via RemindctlHelper.app.

Quick Start

Run the wrapper to verify authorization: <project-root>/.agent/skills/apple-reminders/remindctl-wrapper.sh status --json List reminders in the Assistant list: <project-root>/.agent/skills/apple-reminders/remindctl-wrapper.sh list --list Assistant --json Add a reminder example: <project-root>/.agent/skills/apple-reminders/remindctl-wrapper.sh add "Buy groceries" --list Assistant --json

Frequently Asked Questions about apple-reminders

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I manage Apple Reminders from a background automation process without permission errors?

Managing Apple Reminders from a background automation process requires routing remindctl commands through a dedicated macOS-permissioned wrapper to avoid permission issues. This approach uses an included shell script and helper app bundle to safely execute operations on a dedicated list without affecting other reminders.

Can I add and complete Apple Reminders from an agent on macOS?

Yes, you can add and complete Apple Reminders from an agent on macOS by using a dedicated wrapper script. The wrapper handles showing, adding, editing, completing, and deleting reminders exclusively within a protected list, ensuring operations are properly authorized via a helper app bundle.

What is the best way to surface due reminders through heartbeat-triggered checks?

The best way to surface due reminders through heartbeat-triggered checks is to use a dedicated wrapper that queries a specific Apple Reminders list. This method enforces permission handling for background processes, reliably displaying due items to the user during scheduled heartbeat intervals.

Do I need remindctl and a helper app to automate reminders management on macOS?

Yes, you need the remindctl tool and the RemindctlHelper.app bundle present on macOS to automate reminders management. These components are required to enforce proper permissions and execute the underlying commands that interact with the Apple Reminders application.

Are my existing Apple Reminders lists affected when using an automation wrapper?

Existing Apple Reminders lists are not affected when using an automation wrapper because operations are restricted to a single, protected list. The wrapper ensures that showing, adding, editing, and deleting actions only occur within this dedicated list, leaving all other user lists untouched.

Why does remindctl fail to run in background processes on macOS?

Remindctl fails to run in background processes on macOS due to system permission restrictions that block direct execution. Bypassing this requires routing commands through a macOS-permissioned wrapper and a helper app bundle, which safely authorizes the background process to interact with Apple Reminders.