What problem does it solve?
It converts an exported calendar file into a clean, readable schedule for the next two weeks, so you can quickly see what’s coming and plan around it.
Core Features & Use Cases
- Freshness-aware scheduling: Reuses the existing
tracking/week.md if it was already updated today to avoid unnecessary reprocessing.
- Calendar validation and setup guidance: Checks whether calendar integration is configured and whether a Python interpreter is available before attempting parsing.
- Two-week schedule generation from export: Finds the most recent file in
calendar_export/, runs _system/parse_calendar.py to produce the schedule, and writes the result back to tracking/week.md, including export metadata and last-updated timing.
- Practical flags for attention: Highlights prep days, unusually packed days (3+ events), and potential free days that could absorb overdue work.
Quick Start
Run /week after you have exported your calendar into calendar_export/ and completed /setup if calendar integration is not configured.