Summary

This Home Assistant add-on enables AI-driven management of smart home configurations, automations, dashboards, and themes via natural language. Targeting experienced Home Assistant users, it transforms complex YAML editing into conversational interactions, accelerating development and simplifying system management.

How It Works

The project employs a dual-module architecture: a Home Assistant add-on (Agent) with native access to HA's internal APIs (REST, WebSocket) and a companion MCP server running alongside the user's AI IDE. This design provides a stable, well-defined API, offering a safer, more predictable, and efficient alternative to SSH-based integrations that rely on ad-hoc script generation.

Quick Start & Requirements

Installation involves adding the repository (https://github.com/coolver/home-assistant-vibecode-agent) to Home Assistant Add-ons, then installing and starting the "HA Vibecode Agent." Users require an AI IDE (Cursor, VS Code) configured with the MCP protocol. Node.js (v18.0.0+) must be installed on the IDE machine to resolve potential spawn npx ENOENT errors. Setup is estimated at 5 minutes. API documentation is available via Swagger UI at http://homeassistant.local:8099/docs post-installation.

Highlighted Details

• AI autonomously creates complex automations, scripts, and systems from natural language prompts.
• Programmatic management of Lovelace dashboards, including card arrangement, layouts, and UI themes.
• Automatic Git-based versioning for all configuration changes, featuring AI-generated commit messages and one-click rollback.
• Seamless integration with HACS for installing and managing community integrations, themes, and custom components.
• Full add-on lifecycle management through the Supervisor API.

Maintenance & Community

Support and discussions are primarily channeled through GitHub Issues and Discussions. No specific details on core maintainers, sponsorships, or a public roadmap were found in the README.

Licensing & Compatibility

The project is released under the permissive MIT License, generally allowing for commercial use and integration into closed-source projects.

Limitations & Caveats

This tool is intended for experienced Home Assistant users due to the potential for AI-generated errors that could break configurations. Users must diligently review AI-proposed changes, test in safe environments, and ensure their IDE is correctly set up. A prerequisite is the installation of Node.js on the machine running the AI IDE.