A command-line interface for Apple Reminders that supports natural language dates and location-based geofencing triggers.
Install & Download
1. ClawHub CLI
The fastest way to install a skill directly from the registry.
npx clawhub@latest install timely
2. Manual Installation
Copy the skill folder to one of these locations
~/.openclaw/skills/ <project>/skills/ Priority: Workspace > Local > Bundled
3. Prompt Installation
Copy this prompt to OpenClaw to install it automatically.
Help me install timely using Clawhub. If Clawhub is not installed, install it first (npm i -g clawhub).
Prefer to download?
Get the raw skill files in a ZIP archive.
What is timely?
timely is a robust CLI utility designed specifically for macOS users who want to interact with the Apple Reminders ecosystem without leaving the terminal. As a specialized addition to the library of Openclaw Skills, it provides a seamless way to create, view, and manage tasks across iCloud-synced lists. By leveraging the native EventKit framework, it ensures that every reminder created via the command line is instantly available across all your Apple devices.
This tool is built for developers and power users who value speed and automation. It eliminates the need for manual GUI interactions, allowing you to incorporate task management into your shell scripts or development workflows. Whether you are setting a quick reminder for a meeting or a complex location-aware alert for your commute, timely handles the logic silently and efficiently.
timely Use Cases
- Creating time-sensitive tasks using natural language inputs like tomorrow 3pm or next friday.
- Setting up location-based alerts that trigger specifically when you arrive at or depart from a physical address.
- Viewing and managing tasks within specific iCloud lists directly from your developer environment.
- Integrating reminder creation into automated scripts as part of your Openclaw Skills toolkit.
How timely Works
- The user inputs a command specifying the target list, task title, and optional flags for time or location.
- The CLI parses natural language strings to determine the exact due date and time.
- If location flags are used, the tool geocodes the provided address to establish a geofence boundary.
- timely communicates with the macOS EventKit API to write the data directly to the local Reminders database.
- The macOS system automatically synchronizes these changes with iCloud, updating all connected devices in real-time.
timely Setup
To integrate this tool into your collection of Openclaw Skills, install it via Homebrew using the following commands:
brew tap halbotley/tap
brew install timely
Upon the first execution, macOS will prompt for permission to access your Reminders. You must authorize this request in System Settings > Privacy & Security > Reminders to allow the CLI to interact with your data.
timely Data Schema & Taxonomy
The skill manages data according to the native Apple Reminders schema, ensuring full compatibility with the official app. Key data points include:
| Attribute | Description | Input Example |
|---|---|---|
| List | The target iCloud reminder list | Reminders, Work, Shopping |
| Title | The primary text of the task | Call mom, Submit report |
| Due Date | Parsed time-based alert | friday 5pm, 2025-03-15 |
| Location | Display name for the geofence | Office, Home, Trader Joe's |
| Address | Geocoded physical location | 123 Main St, Santa Barbara, CA |
| Trigger | The boundary crossing event | --arrive or --depart |
timely Advanced Features
- Support for complex natural language date parsing, reducing the need for strict timestamp formatting.
- Proximity-based geofencing with a default 100-meter radius for highly accurate location triggers.
- Full compatibility with shared iCloud lists, enabling multi-user task coordination from the terminal.
- Zero-UI operation, making it a perfect candidate for headless automation within your Openclaw Skills environment.
SKILL.md
Loading
Related Openclaw Skills
Session Hygiene
Maintain peak performance by automatically archiving stale session data and preventing database bloat in your AI agent environment.
duely
A lightweight command-line utility for scheduling, tracking, and logging recurring maintenance tasks and periodic chores.
calmly
A silent macOS command-line tool for managing Calendar events via EventKit, bypassing slow AppleScript and UI prompts.
Klaw Arena
Klaw Arena is an autonomous, agent-first RPG where AI klaws farm gold, engage in strategic arena combat, and progress through a competitive ranking system.
Complex Task Three-Step Methodology
A sophisticated three-step framework designed to guide AI agents through zero-cost screening, lightweight assessment, and deep DAG-based planning for complex task execution.
Config Preflight Validator
A specialized local validation utility designed to verify configuration files and patches against the official schema before deployment.
Featured*
