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

Full YouTube Demo:

• How to control Home Assistant from Cursor

🎯 What is this?

HA Vibecode Agent is a Home Assistant add-on that exposes a safe on-board REST API and toolset, allowing AI assistants (Cursor, VS Code, Claude, Continue, and any MCP-enabled IDE) to work with your Home Assistant instead of just generating YAML in the dark.

🔍 Analyze your setup

✅ Read your full configuration — entities, automations, scripts, helpers
✅ Understand your devices — capabilities, relations, and usage patterns
✅ Learn existing logic — analyze how your current automations and scripts behave

🏗️ Build intelligence

✅ Create complete systems — multiple interconnected automations in seconds
✅ Generate helpers and sensors — tailored to your actual setup and needs
✅ Write optimized scripts — based on real entities, areas, and devices
✅ Refactor existing logic — improve or merge automations instead of starting from scratch

📊 Dashboards & UI

✅ Create and update Lovelace dashboards — fully programmatically
✅ Add, remove, or rearrange cards — stat, graphs, history, custom cards, and more
✅ Control layouts and views — organize rooms, areas, and scenarios
✅ Design and tweak themes — colors, typography, and styles for a personalized UI

🔒 Safe operations

✅ Git-based versioning — every change is tracked with meaningful commit messages
✅ Human-readable commits — AI explains what changed and why
✅ Configuration validation — test before apply to reduce breaking changes
✅ One-click rollback — revert to a previous state if something goes wrong
✅ Activity log — full audit trail of what the agent did and when

📦 Extend with the community

✅ Install and configure HACS — unlock 1000+ community integrations
✅ Search repositories — themes, plugins, custom components, dashboards
✅ Install integrations — one-command setup for new HACS components
✅ Keep things fresh — update all HACS repositories from a single place

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

🚀 How is this different from other MCP modules for Home Assistant?

Most MCP integrations I’ve seen for Cursor, VS Code or Claude work only on your local machine and talk to Home Assistant over SSH and sometimes the REST API.

For serious Home Assistant work, that’s not really enough:

Home Assistant is not just a bunch of YAML files. It exposes multiple internal APIs, and some of the most important ones are only available from inside HA itself over the WebSocket API.

When you access HA only via SSH, the AI usually has to generate and upload a helper script on every request, then execute it blindly on the host. Since that script can be different every time, each request is a bit of a black box — more like playing Russian roulette than doing reliable automation.

Because of that, I chose a different architecture.

This project is split into two modules:

Home Assistant Agent (this module) – runs inside Home Assistant (as an add-on), has native access to all relevant APIs, files and services, and exposes a safe, well-defined interface for external tools.

Home Assistant MCP server – runs on your computer alongside your AI IDE (Cursor, VS Code, etc.) and talks to the Agent over a controlled API instead of SSH hacks (installation steps below)

This design makes working with Home Assistant faster, more predictable, safer and repeatable. Your AI IDE gets exactly the actions and data it needs — through a stable API — instead of constantly inventing ad-hoc scripts and hoping they behave correctly.

🌟 Features

🏠 Home Assistant Integration

• Full access to HA REST API and WebSocket
• List all entities and their states
• Call any HA service
• Reload components (automations, scripts, templates)
• Check configuration validity
• Real-time state monitoring

📊 Dashboards & Themes

• Create and update Lovelace dashboards programmatically
• Add, remove, and rearrange cards (stat, graphs, history, custom cards, etc.)
• Manage views, layouts, and groups for rooms and areas
• Create and tweak themes for fully customized UI appearance
• Safely adjust dashboards and themes through AI-driven operations

📁 File Management

• List, read, write, append, delete files
• Automatic backup before modifications
• YAML parsing and validation
• Safe path handling (restricted to /config)

🔧 Component Management

• Create/Delete Input Helpers (boolean, text, number, datetime, select)
• Create/Delete Automations
• Create/Delete Scripts
• Automatic reload after changes

💾 Git Versioning

• Automatic commit on every change with meaningful commit messages
• AI-generated descriptive messages explaining what and why changed
• Backup history (up to 30 commits, configurable)
• Automatic cleanup of old commits to prevent repository bloat
• View change history – ask AI to show recent commits with meaningful messages
• Easy rollback – ask AI to rollback to any previous version by description or commit hash
• View diffs between versions
• Commit messages include operation context (e.g., "Add automation: Control lights when motion detected")

Example AI interactions:

• "Show me the last 10 changes to my configuration" → AI displays commit history with meaningful messages
• "Something broke! Roll back to the version from yesterday" → AI finds and restores previous version
• "What changed in the last commit?" → AI shows detailed diff
• "Roll back to when I added the motion sensor automation" → AI finds and restores that specific commit

📡 Monitoring & Troubleshooting

• Agent logs API with filtering
• Operation history
• Real-time status
• Health check endpoint
• System monitoring and analysis

🔌 Add-on Management

Complete add-on lifecycle management – install, configure, and control services!

• Install/uninstall add-ons (Zigbee2MQTT, Node-RED, ESPHome, etc.)
• Configure add-on options
• Start/stop/restart add-ons
• Monitor add-on logs
• Update add-ons
• Powered by Supervisor API

📦 HACS Management

Complete HACS integration via WebSocket – browse 1000+ custom integrations!

• Install HACS automatically from GitHub
• Search repositories by name, author, or category
• Install integrations, themes, and plugins
• Update all installed repositories
• View repository details (stars, versions, authors)
• Powered by persistent WebSocket connection

⚡ Quick Start (5 minutes)

1. Add Repository

Open your Home Assistant UI (usually http://homeassistant.local:8123):

1. Go to Settings → Add-ons → Add-on Store → ⋮ → Repositories (usually http://homeassistant.local:8123/hassio/dashboard )
2. Add: https://github.com/coolver/home-assistant-vibecode-agent
3. Click Add

2. Install and Start Add-on

Still in Home Assistant UI:

1. Refresh the page
2. Find HA Vibecode Agent → Click INSTALL
3. Wait for installation to complete
4. Enable → Start on boot: ON → and push START button
5. Wait for startup (~10 seconds)
6. Click "Open Web UI" button

You'll see this interface:

7. Click the Cursor or VS Code tab (depending on which IDE you want to use with Home Assistant) and follow the setup instructions. You’ll need to install and configure Cursor or VS Code so they can connect to the HA Agent via the MCP protocol.

8. That’s it — you’re ready to start working with your Home Assistant scripts, automations and dashboards using AI. If you find this project useful and want to support its development, **please consider giving it a [GitHub Star](https://github.com/Coolv