gws-calendar-agenda

Displays upcoming Google Calendar events across all calendars via the gws CLI.

Updated Nov 9, 2023
One-click install
npx skills add https://github.com/oresttokovenko/dot-files --skill gws-calendar-agenda-oresttokovenko
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: gws-calendar-agenda
Source: https://github.com/oresttokovenko/dot-files/tree/main/chezmoi/dot_agents/skills/gws-calendar-agenda
Command: npx skills add https://github.com/oresttokovenko/dot-files --skill gws-calendar-agenda-oresttokovenko

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Checking your schedule across multiple Google Calendars normally requires opening a browser or app; this Skill surfaces upcoming events directly from the command line in a single read-only query. ## Core Features & Use Cases - Agenda View: Lists upcoming events across all calendars with one command, with no risk of modifying any event. - Flexible Time Ranges: Filter by today, tomorrow, this week, or a custom number of days ahead. - Calendar and Timezone Filtering: Narrow results to a specific calendar by name or ID, and override the timezone with any IANA value. - Use Case: Before your morning standup, run the agenda command with the --today flag to see every meeting scheduled across your work and personal calendars in one list. ## Quick Start Ask the assistant to show your Google Calendar agenda for today using the gws calendar +agenda command.

Frequently Asked Questions about gws-calendar-agenda

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I see my Google Calendar agenda from the command line?

Run gws calendar +agenda to list upcoming events across all your Google Calendars. Add flags like --today, --tomorrow, or --week to narrow the time range shown.

How to filter Google Calendar events to one calendar?

Use the --calendar flag with a calendar name or ID, for example gws calendar +agenda --calendar 'Work'. Without this flag, the command queries all calendars by default.

Can I view my calendar agenda in a different timezone?

Yes, pass an IANA timezone with the --timezone flag, such as --timezone America/New_York. By default the command uses your Google account timezone.

Does the gws calendar agenda command modify my events?

No, the agenda command is strictly read-only and never modifies events. It only queries and displays upcoming events from your calendars.

Why does gws calendar +agenda fail with an auth error?

The command requires the gws binary and an authenticated Google account. Read the gws-shared skill documentation for auth setup and global flags, or run gws generate-skills if that file is missing.