Calendar Agenda

Real calendar events for the Omarchy v4 bar — not another empty month grid. A 󰃭 chip counts down to your next event ("Standup · in 25 m", accent-colored inside ten minutes), and clicking it opens a two-week agenda grouped by day.

Feed it any ICS export URL: Google Calendar's "secret address", Proton/Outlook/Nextcloud share links, webcal:// links, public holiday feeds. Multiple calendars merge into one agenda.

The parser is dependency-free and handles the real world: folded lines, quoted parameters, all-day events (with RFC 5545's exclusive DTEND), recurring events (DAILY/WEEKLY/MONTHLY/YEARLY with INTERVAL, BYDAY including nth-weekday, BYMONTHDAY, UNTIL, COUNT), EXDATE/RDATE, and RECURRENCE-ID overrides.

Known limitation: TZID times are treated as local wall-clock time — correct for events you created in your own timezone; an event pinned to a different zone will show its wall-clock time, not yours.

Install

omarchy plugin add https://github.com/devmobasa/omarchy-calendar-agenda --enable
omarchy bar set community.calendar-agenda urls '["https://calendar.google.com/calendar/ical/…/basic.ics"]'

Settings

Key	Default	Meaning
urls	[]	ICS export URLs (up to 8; webcal:// accepted)
refreshMinutes	30	Fetch cadence (floor 5; only one bar instance fetches)

Scripting

omarchy-shell community.calendar-agenda refresh
omarchy-shell community.calendar-agenda status
omarchy-shell shell toggle community.calendar-agenda '{}'   # the agenda panel

Tests

OMARCHY_PATH=/path/to/omarchy ./test/all

License

MIT