A native macOS Calendar CLI designed for both humans and AI agents. ical provides direct memory access to the Calendar store — 3000x faster than AppleScript, with zero IPC overhead. It uses go-eventkit to facilitate this, a library I wrote for evenkit-go bindings. rem uses this too!
Built for Agents:
ical ships with an Agent Skill following the agentskills.io open format — AI coding agents like Claude Code, Cursor, and Gemini CLI can discover and use it autonomously. Structured JSON output (-o json), deterministic exit codes, and --force flags for non-interactive execution make it a first-class tool in agentic workflows.
Key Features:
- Single Binary — EventKit compiled into the Go binary via cgo. Install in seconds
- Natural Language Dates — 20+ patterns: "tomorrow at 3pm", "next friday", "in 2 hours", "eod"
- Interactive Mode — Guided forms and searchable event picker for human use
- JSON / CSV / ICS — Structured export for scripting and agent consumption. CSV and JSON import with dry-run preview.
- Full CRUD + Recurrence — Events and calendars. Daily, weekly, monthly, yearly recurrence.
- Calendar Management — Create, rename, recolor, and delete calendars across iCloud, Google, and other sources.
Open source under MIT. Documentation at ical.sidv.dev.
Built with