A silent macOS command-line tool for managing Calendar events via EventKit, bypassing slow AppleScript and UI prompts.
Install & Download
1. ClawHub CLI
The fastest way to install a skill directly from the registry.
npx clawhub@latest install calmly
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 calmly 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 calmly?
calmly is a lightweight CLI utility built specifically for macOS users who need to manage their calendars without the overhead of GUI interruptions. While traditional automation methods like AppleScript often hang or require manual permission dialogs, calmly utilizes the native EventKit framework to interact directly with calendar data. This ensures that event creation and retrieval are handled silently and efficiently, making it a robust choice for users integrating Openclaw Skills into their terminal-based productivity workflows.
By focusing on a non-interactive experience, it solves the common problem of automation scripts getting stuck on UI popups. Whether you are managing local calendars, iCloud accounts, or CalDAV-synced schedules, this tool provides a predictable and scriptable interface for modern macOS environments.
calmly Use Cases
- Creating calendar events programmatically during development or deployment cycles.
- Querying upcoming schedules directly from the terminal without opening the Calendar app.
- Automating the setup of recurring or batch events through shell scripts.
- Managing multiple calendar categories like Work, Family, or Fitness with simple CLI commands.
How calmly Works
- The tool receives commands and arguments (like calendar name, event title, and dates) from the terminal.
- It interfaces with the macOS EventKit framework to securely access the user's calendar database.
- For creation tasks, it validates the date/time strings and injects the event into the specified calendar.
- For viewing tasks, it fetches and formats upcoming events for display in the terminal output.
- Changes are automatically synchronized to all devices via the standard macOS background sync process.
calmly Setup
To get started with this skill, install the utility via Homebrew by tapping the official repository:
brew tap halbotley/tap
brew install calmly
After installation, run any command to trigger the initial macOS privacy prompt. You must grant the application permission to access your Calendars under System Settings > Privacy & Security > Calendars.
calmly Data Schema & Taxonomy
The skill relies on specific string formats to ensure accurate event scheduling. It maps terminal input to EventKit properties as follows:
| Parameter | Requirement | Example |
|---|---|---|
| Date Format | YYYY-MM-DD | 2025-03-15 |
| Time Format | HH:MM (24-hour) | 14:30 |
| Calendar Name | Case-insensitive String | Work, Kids, Personal |
| Event Title | Quoted String | "Project Sync" |
calmly Advanced Features
- Support for multi-day event spans using start and end date parameters.
- Seamless iCloud, local, and CalDAV calendar integration.
- Optimized for headless execution within scripts, avoiding all AppleScript UI dependencies.
- Ability to verify date alignment using native macOS date utilities before batch creation.
- High-performance event listing with configurable look-ahead windows (e.g., 14 or 30 days).
SKILL.md
Loading
Related Openclaw Skills
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.
UA1 Validator Agent
A specialized agent skill for running deterministic PDF/UA-1 accessibility checks and remediation loops via the ua1.dev API.
AlphaFactoryX
A comprehensive financial data suite providing SEC filings, sentiment analysis, and macro indicators for US equity research.
gog Google Workspace CLI
A robust command-line interface for managing Gmail, Calendar, Drive, Contacts, Sheets, and Docs with ease.
duely
A lightweight command-line utility for scheduling, tracking, and logging recurring maintenance tasks and periodic chores.
Session Hygiene
Maintain peak performance by automatically archiving stale session data and preventing database bloat in your AI agent environment.
Featured*
