week

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.