apple-calendar

Read Apple Calendar from the terminal via icalBuddy (read-only) and create events through osascript AppleScript against Calendar.app. Calendars sync across Apple devices through iCloud.

Setup check (lazy — do NOT probe every turn)

Do not run a --version probe before each request. Just run the calendar command the user asked for (e.g. icalBuddy eventsToday) directly. Only when a command fails map the error to a Setup playbook branch:

• stderr mentions command not found: icalBuddy → Setup playbook → "icalBuddy is not installed".
• a read returns nothing and stderr mentions calendar access / not authorized → Setup playbook → "Calendar permission missing".
• macOS not detected (e.g. uname returns Linux) → reply that this skill is macOS-only and stop. Do NOT try to install anything.

If unsure which branch applies, capture stderr and ask the user before proceeding.

Setup playbook (when prerequisites are missing)