$git clone https://github.com/Coolver/home-assistant-vibecode-agentLet 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. π π€
| 1 | # HA Vibecode Agent |
| 2 | Β |
| 3 | [](https://github.com/Coolver/home-assistant-vibecode-agent) |
| 4 | [](LICENSE) |
| 5 | [](https://www.npmjs.com/package/@coolver/home-assistant-mcp) |
| 6 | [](https://coolver.github.io/home-assistant-vibecode-agent/) |
| 7 | Β |
| 8 | **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. π π€** |
| 9 | Β |
| 10 | You describe your goal β AI inspects your Home Assistant β designs a custom solution β and deploys it on-board automatically. π |
| 11 | Β |
| 12 | 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.** |
| 13 | Β |
| 14 | 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: |
| 15 | Β |
| 16 | - π Analyze your Home Assistant configuration, entities, and devices |
| 17 | - ποΈ Create intelligent automations, scripts, and complete systems β including Home Assistant helpers that can be fully managed programmatically |
| 18 | - π¨ Design and customize UI dashboards with full control over cards, layouts, and styling |
| 19 | - ποΈ Create and tweak themes for a personalized UI |
| 20 | - π Safely deploy changes with automatic Git-based versioning |
| 21 | - π Monitor and troubleshoot your setup through log analysis |
| 22 | - π¦ Install and manage HACS integrations and custom repositories |
| 23 | Β |
| 24 | No more manual YAML editing or searching through documentation - just describe what you want in natural language! |
| 25 | Β |
| 26 | **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! |
| 27 | Β |
| 28 | https://github.com/user-attachments/assets/0df48019-06c0-48dd-82ad-c7fe0734ddb3 |
| 29 | Β |
| 30 | **Full YouTube Demo:** |
| 31 | - [How to control Home Assistant from Cursor](https://youtu.be/xocbWonWdoc) |
| 32 | Β |
| 33 | --- |
| 34 | Β |
| 35 | ## π― What is this? |
| 36 | Β |
| 37 | **HA Vibecode Agent** is a service that exposes a safe REST API and toolset, allowing AI assistants (Claude Code, Cursor, VS Code, Antigravity, and any MCP-enabled IDE) to safely work *with* your Home Assistant instead of just generating YAML in the dark. |
| 38 | Β |
| 39 | It supports two deployment modes: |
| 40 | Β |
| 41 | | Mode | For whom | How it runs | |
| 42 | |------|----------|-------------| |
| 43 | | **Supervisor (Add-on)** | Home Assistant OS / Supervised | Installed via HA Add-on Store (default) | |
| 44 | | **Standalone (Docker)** | HA Container in Docker / Proxmox / NAS | Runs as a separate Docker container | |
| 45 | Β |
| 46 | Both modes provide the same core functionality. The only difference: **Add-on management** (install/uninstall/restart add-ons) requires the Supervisor and is not available in standalone mode. |
| 47 | Β |
| 48 | --- |
| 49 | Β |
| 50 | ### π How is this different from other MCP modules for Home Assistant? |
| 51 | Β |
| 52 | # Home Assistant Agent + MCP Server |
| 53 | Β |
| 54 | Most MCP integrations for Claude, Cursor, VS Code or Antigravity run only on your local machine and talk to Home Assistant over SSH, sometimes with the REST API. |
| 55 | Β |
| 56 | For serious Home Assistant work, that is not enough. |
| 57 | Β |
| 58 | Home Assistant is not just a set of YAML files. It exposes internal APIs, runtime state, entities, services and capabilities that are much easier and safer to access from inside Home Assistant itself. |
| 59 | Β |
| 60 | SSH-based integrations often force the AI to generate and run temporary helper scripts on every request. Since those scripts can change every time, the result is hard to predict, hard to repeat and risky to rely on. |
| 61 | Β |
| 62 | This project uses a different architecture. |
| 63 | Β |
| 64 | ## Architecture |
| 65 | Β |
| 66 | The project is split into two modules: |
| 67 | Β |
| 68 | ### Home Assistant Agent |
| 69 | Β |
| 70 | Runs i |