calendar

Calendar

Manage the user's calendar through their own installed tooling — skill + terminal + native CLI. ChatCLI bundles no calendar client; detect what exists and drive it.

Step 0 — Identify the OS first (this is a multi-OS CLI)

ChatCLI runs on Windows, macOS, and Linux. Probe accordingly:

• macOS / Linux (sh): command -v gcalcli khal 2>/dev/null; uname -s
• Windows (PowerShell): Get-Command gcalcli -ErrorAction SilentlyContinue | Select-Object Name

Step 1 — Choose the tool

Preference order:

1. gcalcli — Google Calendar, scriptable, cross-platform (pip). The common case; prefer it.
2. khal — CalDAV/local (privacy-friendly, self-hosted; Unix).
3. macOS with neither → AppleScript Calendar.app via osascript.
4. Windows with neither → Outlook Calendar via PowerShell COM.
5. None → tell the user what to install (pipx install gcalcli / apt install khal) and stop.

Step 2 — Always resolve "now" before scheduling

Relative times ("tomorrow 3pm", "next Tuesday") need an anchor. Get it first:

• macOS / Linux: date '+%Y-%m-%d %H:%M %Z (%A)'
• Windows: Get-Date -Format "yyyy-MM-dd HH:mm zzz (dddd)"

Then compute the absolute start/end and confirm it back to the user.

Step 3 — Create an event

gcalcli:

gcalcli add --title "Sync with Alice" --when "2026-06-05 15:00" --duration 30 --where "Meet" --noprompt

Add --calendar "<name>" to target a specific calendar; gcalcli list shows them.

khal:

khal new 2026-06-05 15:00 16:00 "Sync with Alice"

macOS Calendar (osascript):

osascript -e 'tell application "Calendar" to tell calendar "Home"
  make new event with properties {summary:"Sync with Alice", start date:(date "2026-06-05 15:00"), end date:(date "2026-06-05 15:30")}
end tell'

Windows Outlook (PowerShell COM):

$ol = New-Object -ComObject Outlook.Application
$appt = $ol.CreateItem(1)   # 1 = AppointmentItem
$appt.Subject = "Sync with Alice"
$appt.Start = [datetime]"2026-06-05 15:00"
$appt.Duration = 30
$appt.Save()