Fresh start - excluded large ROM JSON files

docs/calendar-channel/README.md

@@ -0,0 +1,54 @@
+# Calendar Channel - Discord #1474636036905631867
+
+A dedicated calendar space where you can interact with Home Assistant's calendar using natural language.
+
+## Quick Commands
+
+### View Events
+- **"What do I have today?"** → Shows today's schedule
+- **"Show upcoming events"** → Lists events for the next 7 days
+- **"This week's events"** → Shows this week's schedule
+
+### Add Events
+- **"Add [event name] on [YYYY-MM-DD] at [time]"**
+  - Example: `Add grocery run on 2026-02-22 at 3pm`
+  - Example: `Schedule dentist for 2026-02-25 at 10:00`
+  - Example: `New event: Team meeting 2026-02-24 14:00`
+
+### Examples
+
+```
+Add grocery run on 2026-02-22 at 3pm
+→ ✅ Added: grocery run on 2026-02-22 at 3pm
+
+What do I have today?
+→ • Dentist at 10:00
+• Team meeting at 2:00
+
+Show upcoming events
+→ • Team meeting - 2026-02-24 at 14:00
+• Grocery run - 2026-02-22 at 15:00
+• ...
+```
+
+## Files
+
+- **Calendar Agent:** `agents/calendar-agent.py`
+- **HA Calendar API:** `api/ha_calendar.py`
+
+## Technical Details
+
+- Connected to **Home Assistant** at `http://192.168.0.39:8123`
+- Calendar entity: `calendar.appointments`
+- Uses Home Assistant's Calendar API via REST
+- Events added here sync to HA calendar immediately
+
+## Supported Date/Time Formats
+
+| Format | Example |
+|--------|---------|
+| ISO | `2026-02-22 15:00` |
+| Natural | `2026-02-22 3pm` |
+| Date only | `2026-02-22` (defaults to 9 AM) |
+
+Commands are case-insensitive and flexible—just speak naturally!