rem

What This Skill Does

The rem skill provides a powerful, high-performance interface for managing Apple Reminders directly from your terminal or via an AI agent. Built in Go with CGO and EventKit integration, it offers sub-200ms read times, making it an exceptionally fast way to interact with your native macOS task database. The skill allows you to perform full CRUD operations (Create, Read, Update, Delete) on reminders, manage specific lists, search through task history, and even handle bulk operations like imports and exports. By wrapping the Apple Reminders ecosystem in a command-line interface, it bridges the gap between structured task management and automated workflows, enabling you to manipulate your personal or work agenda using natural language date parsing and complex filtering.

Installation

To integrate this skill into your agent, ensure you are in your target environment and execute the following:

1. Install the CLI binary via curl or Go (ensure you have Go installed): curl -fsSL https://rem.sidv.dev/install | bash

2. Install the skill into OpenClaw: clawhub install openclaw/skills/skills/bro3886/rem-cli

Verify the installation by running rem version or checking rem skills status to ensure the agent has correctly linked the binary to the execution environment.

Use Cases

This skill is perfect for users who live in the terminal and want to manage their to-do lists without switching windows or navigating the Reminders GUI. It is ideal for:

• Automating Workflows: Scripting the creation of recurring tasks based on system events or log output.
• Quick Capture: Rapidly adding tasks with natural language dates (e.g., 'remind me to check server logs tomorrow at 9am') during a coding session.
• Task Analysis: Using the rem stats and rem export features to analyze task completion patterns over time.
• Bulk Management: Efficiently clearing out or updating large volumes of reminders that would be tedious to handle via click-and-drag in the standard macOS app.

Example Prompts

1. "Check my work list for any incomplete tasks and show me what is due today."
2. "Add a new reminder to my Personal list: Buy groceries for the weekend, set priority to high, and remind me tomorrow."
3. "Search for all reminders mentioning 'meeting', display them, and mark the one labeled 'sync' as complete."

Tips & Limitations

• Short IDs: You don't need the full UUID of a reminder. The CLI uses 8-character short IDs for all commands. If you are completing a task, just use the first few unique characters of the ID.
• Natural Language: The skill excels at parsing dates. Use 'tomorrow', 'next week', or specific times to let the CLI handle the scheduling logic.
• Performance: Because it uses native EventKit, it is significantly faster than AppleScript or Shell-based GUI scraping.
• Limitations: Note that this is a macOS-only tool. It relies on the local Apple Reminders database and will not function on Linux or Windows environments.