Auto-sync: 20260114-183121

CLAUDE.md

@@ -315,6 +315,19 @@ git add -A && git commit -m "Update docs" && git push
 
 ## Recent Changes
 
+### 2026-01-14
+- **Guitar Room Humidity Automation** setup complete
+  - Homebridge installed on Mac Mini with `homebridge-plugin-govee` for BLE sensor access
+  - Govee H5074 temperature/humidity sensor bridged to Home Assistant
+  - VeSync integration added for Levoit LV600S humidifier control
+  - Automations created: turn ON below 45%, turn OFF above 47%
+  - Target: maintain 45-47% humidity for Lowden guitar storage
+- **New Home Assistant integrations:**
+  - VeSync (vesync@htsn.io) - humidifier control
+  - HomeKit Controller - Homebridge bridge
+- **Homebridge service:** `~/Library/LaunchAgents/com.homebridge.server.plist`
+- **New HA entities:** `sensor.goveeh5074_5059_humidity`, `humidifier.lv600s`
+
 ### 2026-01-11
 - **BlueMap web map** for Minecraft Hutworld server
   - URL: https://map.htsn.io (password protected: hutworld / Suwanna123)
@@ -372,8 +385,8 @@ git add -A && git commit -m "Update docs" && git push
 
 ---
 
-**Last Updated**: 2026-01-05
-**Documentation Status**: ✅ Phase 1 Complete + Gateway Monitoring + MetaMCP + Tailscale
+**Last Updated**: 2026-01-14
+**Documentation Status**: ✅ Phase 1 Complete + Gateway Monitoring + MetaMCP + Tailscale + Humidity Automation
 
 ---
 

HOMEASSISTANT.md

@@ -132,6 +132,8 @@ curl -s -H "Authorization: Bearer $HA_TOKEN" \
 - **Sonos** - Speakers
 - **Motion Sensors** - Various locations
 - **NUT (Network UPS Tools)** - UPS monitoring (added 2025-12-21)
+- **VeSync** - Levoit humidifier control (added 2026-01-14)
+- **HomeKit Controller** - Homebridge bridge for Govee sensors (added 2026-01-14)
 
 ### NUT / UPS Integration
 
@@ -168,9 +170,76 @@ entities:
     name: Input Voltage
 ```
 
+### VeSync / Levoit LV600S Integration
+
+Controls the Levoit LV600S humidifier via VeSync cloud API.
+
+**Account:** vesync@htsn.io
+
+**Entities:**
+| Entity ID | Description |
+|-----------|-------------|
+| `humidifier.lv600s` | Main humidifier on/off control |
+| `sensor.lv600s_humidity` | Built-in humidity sensor (reads high near mist) |
+| `number.lv600s_mist_level` | Mist intensity (1-9) |
+| `switch.lv600s_display` | Display on/off |
+| `binary_sensor.lv600s_low_water` | Low water warning |
+| `binary_sensor.lv600s_water_tank_lifted` | Tank removed detection |
+
+### HomeKit Controller / Homebridge Integration
+
+Connects to Homebridge running on Mac Mini to access BLE devices (Govee sensors).
+
+**Homebridge Details:**
+- Host: Mac Mini (localhost)
+- Port: 51826
+- PIN: 031-45-154
+- Config: `~/.homebridge/config.json`
+- Logs: `~/.homebridge/homebridge.log`
+- LaunchAgent: `~/Library/LaunchAgents/com.homebridge.server.plist`
+
+**Govee H5074 Entities:**
+| Entity ID | Description |
+|-----------|-------------|
+| `sensor.goveeh5074_5059_humidity` | Room humidity (accurate reading) |
+| `sensor.goveeh5074_5059_temperature` | Room temperature |
+| `sensor.goveeh5074_5059_battery` | Sensor battery level |
+
+**Homebridge Management:**
+```bash
+# Check status
+launchctl list | grep homebridge
+
+# View logs
+tail -f ~/.homebridge/homebridge.log
+
+# Restart Homebridge
+launchctl stop com.homebridge.server
+launchctl start com.homebridge.server
+
+# Stop Homebridge
+launchctl unload ~/Library/LaunchAgents/com.homebridge.server.plist
+
+# Start Homebridge
+launchctl load ~/Library/LaunchAgents/com.homebridge.server.plist
+```
+
 ## Automations
 
-TODO: Document key automations
+### Guitar Room Humidity Control
+
+Maintains 45-47% humidity for guitar storage (Lowden recommends 49% ±2%).
+
+**Automations:**
+| Automation | Trigger | Action |
+|------------|---------|--------|
+| `guitar_room_humidity_low_turn_on_humidifier` | Govee H5074 < 45% | Turn ON humidifier, set mist to 6 |
+| `guitar_room_humidity_reached_turn_off_humidifier` | Govee H5074 > 47% | Turn OFF humidifier |
+
+**Why two thresholds (hysteresis):**
+- Prevents rapid on/off cycling
+- 45% turn-on, 47% turn-off creates a 2% buffer
+- Target range: 45-47% (conservatively below Lowden's 49% spec)
 
 ## TODO