home-assistant-vibecode-agent — MCP Agent for Home Assistant

Main

• 按你的 HA 形态选部署：OS/Supervised 用 Add-on；HA Container 用独立 Docker 方案。

• 使用 Long-Lived Access Token，并避免出现在聊天记录里；放到 .env 并定期轮换。

• 把 AI 生成/修改的自动化与面板当作 PR：先 review 再部署，避免“自动化风暴”。

• 开启写权限时务必限制路径到 HA 配置目录，避免误改系统文件或删库式操作。

README (excerpt)

HA Vibecode Agent

Let AI build your Home Assistant automations – or act as your DevOps for the ones you write by hand. Just describe what you need in natural language. 🏠🤖

You describe your goal → AI inspects your Home Assistant → designs a custom solution → and deploys it on-board automatically. 🚀

And if you prefer to handcraft your automations and scripts yourself, the agent can simply act as your DevOps and extra pair of hands: quickly uploading your changes, running tests, and analyzing logs on demand. You stay in control and decide how much you delegate to AI and how deep it should go.

Transform the way you manage your smart home. This agent enables Claude Code, Cursor, Visual Studio Code (VS Code), or any MCP-enabled IDE to:

• 📝 Analyze your Home Assistant configuration, entities, and devices
• 🏗️ Create intelligent automations, scripts, and complete systems — including Home Assistant helpers that can be fully managed programmatically
• 🎨 Design and customize UI dashboards with full control over cards, layouts, and styling
• 🖌️ Create and tweak themes for a personalized UI
• 🔄 Safely deploy changes with automatic Git-based versioning
• 🔍 Monitor and troubleshoot your setup through log analysis
• 📦 Install and manage HACS integrations and custom repositories

No more manual YAML editing or searching through documentation - just describe what you want in natural language!

Real example: User says "Install smart climate control" → AI analyzes 7 TRVs, creates 10 automations + 9 helpers + 10 sensors + 5 scripts, deploys everything, and it just works!

https://github.com/user-attachments/assets/0df48019-06c0-48dd-82ad-c7fe0734ddb3

Source-backed notes

• README 提供两种安装方式：HA Add-on，以及独立 Docker Compose 模式。
• README 的独立模式使用 .env 配置 HA_URL/HA_TOKEN/HA_CONFIG_PATH，并用 docker compose ... up -d 启动。
• README 说明首次启动会生成 API Key，可从日志或 HA 配置目录中的文件读取。

FAQ

• 该选哪种安装方式？：README 建议：HA OS/Supervised 用 Add-on；HA Container 用独立 Docker。
• Token 从哪来？：README 指引在 HA UI 的 Profile 里创建 Long-Lived Access Token。
• 连接不通怎么排查？：先看容器日志确认 API key，再确认 IDE 指向 http://<host-ip>:8099。