calctl

What This Skill Does

The calctl skill provides a robust interface for managing Apple Calendar events directly from the OpenClaw AI agent. It acts as a bridge between your natural language requests and the native macOS calendar database. By utilizing icalBuddy for efficient, read-only event retrieval and custom AppleScript commands for reliable calendar modifications, this skill turns your terminal into a powerful scheduling hub. Whether you need to quickly check your availability for the week, jot down a new meeting, or search for legacy events, calctl handles the underlying system calls so you don't have to navigate complex GUI menus.

Installation

Before enabling this skill, ensure you have the ical-buddy utility installed via Homebrew. Run the command brew install ical-buddy in your terminal. Once confirmed, install the skill into your OpenClaw environment using the command: clawhub install openclaw/skills/skills/rainbat/calctl. Ensure your terminal emulator has sufficient permissions to control System Events if prompted by macOS during the first use.

Use Cases

• Personal Productivity: Quickly log appointments or all-day events without leaving your current workspace.
• Meeting Management: Search for past or future meetings to track project timelines or identify when you last spoke with a client.
• Work-Life Balance: Keep distinct calendars for 'Work' and 'Privat' separate, using flags to toggle where events are saved.
• Automated Planning: Use the agent to batch add events from a text file or email thread into your calendar.

Example Prompts

• "What does my schedule look like for the rest of this week, and do I have any conflicting meetings on Wednesday?"
• "Add a meeting titled 'Project Review' to my Work calendar for January 22nd at 3:00 PM and make sure to include the note 'Bring quarterly report'."
• "Search for any events related to 'Client' in the last 30 days and list the dates they occurred."

Tips & Limitations

For the best results, use standard YYYY-MM-DD date formats when interacting with the CLI. Remember that calctl relies on the exact name of the calendar in your macOS system; if you have renamed a calendar, update your command strings accordingly. The search function is limited to a 30-day window to maintain performance. Since AppleScript interacts with the GUI layer of Calendar, ensure your machine is unlocked or that your system settings allow background automation for the terminal.