gws-calendar-agenda

# calendar +agenda

> **PREREQUISITE:** Read `../gws-shared/SKILL.md` for auth, global flags, and security rules. If missing, run `gws generate-skills` to create it.

Show upcoming events across all calendars

Usage

```bash

gws calendar +agenda

```

Flags

| Flag | Required | Default | Description |

|------|----------|---------|-------------|

| `--today` | — | — | Show today's events |

| `--tomorrow` | — | — | Show tomorrow's events |

| `--week` | — | — | Show this week's events |

| `--days` | — | — | Number of days ahead to show |

| `--calendar` | — | — | Filter to specific calendar name or ID |

| `--timezone` | — | — | IANA timezone override (e.g. America/Denver). Defaults to Google account timezone. |

Examples

```bash

gws calendar +agenda

gws calendar +agenda --today

gws calendar +agenda --week --format table

gws calendar +agenda --days 3 --calendar 'Work'

gws calendar +agenda --today --timezone America/New_York

```

Tips

• Read-only — never modifies events.
• Queries all calendars by default; use --calendar to filter.
• Uses your Google account timezone by default; override with --timezone.