Homey Docs Companion

Homey Docs Companion tracks changes to your flows, devices, variables, and zones, and provides two tools for understanding and documenting your Homey setup. CROSS-REFERENCE VIEWER Shows which flows use each variable (Homey or Better Logic Library), FlowBits event, label, timer, and programmatic trigger. Use it to answer questions like "which flows write to this variable?" or "what fires this FlowBits event?" without reading through every flow individually. Flows link directly to the Homey flow editor. The viewer has a search filter, collapsible entries, and role badges (reads, writes, triggers on, fires, checks, etc.) with tooltip descriptions. ACCESSING THE CROSS-REFERENCE VIEWER Option A — Via GitHub Pages (recommended, works in all browsers including Safari) https://jmdraper.github.io/homey-docs/cross-refs.html Log in with your Athom account when prompted. Your session is remembered so subsequent visits load directly without logging in again. Requires the companion app to be installed and running on your Homey. Option B — Local network (advanced users) http://[homey-ip]:8734/ Works in Chrome and Firefox on your local network without any additional setup. Safari requires either a reverse proxy providing HTTPS, or a one-time insecure content exception in Safari Settings → Websites. AI ASSISTANT INTEGRATION (MCP) An MCP (Model Context Protocol) server runs on Homey and gives AI assistants such as Claude direct read access to your flows, devices, variables, zones, and change history. Once connected, you can ask your AI to explain what a flow does, find dependencies, or build and maintain a living documentation system that updates automatically when your flows change. Setup takes three steps — all explained in the viewer's Setup panel: 1. Install mcp-remote on your Mac or PC (one-time) 2. Add a short config entry to Claude Desktop 3. Restart Claude Desktop No API tokens or external accounts are required beyond the AI tool itself. CHANGE TRACKING The app polls Homey every five minutes and records when flows are created, modified, renamed, deleted, enabled, or disabled, along with changes to devices and variables. The changelog is available to AI assistants via the MCP server, so syncing documentation only requires fetching what actually changed rather than re-reading everything. REQUIREMENTS - Homey Pro (local platform) - Claude Desktop or another MCP-compatible AI tool for the AI integration features - The cross-reference viewer and change tracking work without any AI tool GETTING STARTED Open http://[homey-ip]:8734/ in a browser on your local network after installing the app. The Setup panel walks through connecting Claude and building your first documentation.