calendarlisted

# Calendar Skill View agenda, create and manage events, check availability, and manage calendars using the `gws` CLI. --- ## Auth Approach Do NOT check authentication upfront. Just run the command. If it fails with an auth error (exit code 2), see the **Self-Healing** section for diagnostics. --- ## Tool Preference All operations use the `gws` CLI directly. No wrapper scripts. - **Helper commands** (prefixed with `+`): Use for common operations. These handle timezone detection, formatting, and attendee management automatically. - **Raw API calls**: Use when no helper exists. Pass parameters via `--params '<JSON>'` and request bodies via `--json '<JSON>'`. Resource paths are space-separated (e.g., `gws calendar events list`). Always prefer `+` helpers when one exists for the operation. --- ## Operations — Tier 1 (Read) ### View Agenda ```bash gws calendar +agenda gws calendar +agenda --today gws calendar +agenda --tomorrow gws calendar +agenda --week gws calendar +agenda --days 3 gws calendar +agenda --calendar 'Work' gws calendar +agenda --today --timezone America/New_York ``` ### Get Event Details ```bash gws calendar events get --params '{"calendarId": "primary", "eventId": "<id>"}' ``` ### List Events (Filtered) ```bash gws calendar events list --params '{"calendarId": "primary", "timeMin": "<iso>", "timeMax": "<iso>"}' ``` ### Check Availability ```bash gws calendar freebusy query --json '{"timeMin": "<iso>", "timeMax": "<iso>", "items": [{"id": "primar