HA Vibecode Agent

AI-Powered Home Assistant Management

Create and debug automations, design dashboards, tweak themes, modify configs, and deploy changes — using natural language.

78+ Tools v2.10.47 MIT License

Safe Home Assistant Development with AI

The only HA agent that runs inside your Home Assistant. Full API access. Git versioning. Zero SSH hacks.

Runs Inside Home Assistant

  • Direct API access to all HA services
  • No SSH tunnel or port forwarding
  • WebSocket connection for real-time updates
  • Path-validated file operations

Every Change Is Versioned

  • Every edit automatically committed to Git
  • AI-generated commit messages
  • One-command rollback to any state
  • Full change history and audit trail

Works with Your IDE

  • Claude Code, Cursor, VS Code, Windsurf
  • Standard MCP protocol
  • Autonomous multi-step operations
  • Context-aware tool selection

How It Works

Traditional SSH into HA, edit YAML in terminal, hope nothing breaks, no undo
Terminal
SSH
Edit YAML
Home Assistant
Vibecode Agent AI manages your HA from the IDE — versioned, validated, rollback-safe
AI IDE
MCP
Agent + Git
Home Assistant

Features

📁

File Management

Read, write, and manage configuration files with path validation and automatic backups.

Automations & Scripts

Create, edit, and debug automations and scripts with full YAML validation.

🎨

Dashboards & Themes

Design Lovelace dashboards and custom themes through natural language.

📄

Git Versioning & Rollback

Every change tracked in Git with AI-generated commit messages and instant rollback.

📦

HACS & Add-ons

Install and manage HACS integrations and Home Assistant add-ons programmatically.

📈

System & Monitoring

Monitor system health, check logs, manage backups, and restart services.

💡

Entity Management

Query, control, and organize entities, devices, and areas across your smart home.

📅

Calendar & Todo

Manage calendar events and todo lists directly through the agent interface.

🛠

Blueprints

Import, export, and manage automation blueprints from the community and your own library.

Installation

Step 1 — Add the repository

Open Home Assistant → Settings → Add-ons → Add-on Store → Repositories, then add:

https://github.com/coolver/home-assistant-vibecode-agent

Step 2 — Install the add-on

Find HA Vibecode Agent in the store and click Install. Configure your long-lived access token in the add-on settings.

Step 3 — Connect your IDE

Open the add-on Web UI panel in Home Assistant. It shows a ready-to-paste MCP configuration for your IDE — Claude Code, Cursor, VS Code, Windsurf, Codex, and others. Copy it and add to your IDE settings.

Step 1 — Pull the image

docker pull ghcr.io/coolver/ha-vibecode-agent:latest

Step 2 — Create a config

mkdir -p /opt/ha-vibecode-agent
cat > /opt/ha-vibecode-agent/.env <<EOF
HA_URL=http://homeassistant.local:8123
HA_TOKEN=your_long_lived_access_token
EOF

Step 3 — Run the container

docker run -d \
  --name ha-vibecode-agent \
  --restart unless-stopped \
  --env-file /opt/ha-vibecode-agent/.env \
  -p 8099:8099 \
  ghcr.io/coolver/ha-vibecode-agent:latest

Step 4 — Connect your IDE

Open http://YOUR_HOST:8099 in a browser. The agent shows a ready-to-paste MCP configuration for your IDE — Claude Code, Cursor, VS Code, Windsurf, Codex, and others. Copy it and add to your IDE settings.

What's Included

Capability Add-on Mode Standalone Docker
File management (read/write/list/delete)
Automations & scripts CRUD
Dashboard & theme management
Git versioning & rollback
Entity control & monitoring
HACS integration
Blueprints, Calendar, Zones
History & statistics
System logs & diagnostics
Add-on management

FAQ

How does the architecture work?

The agent runs inside Home Assistant (as an add-on or sidecar container) with direct access to all HA APIs, the file system, and WebSocket. Your IDE communicates with the agent via a lightweight MCP client over HTTP — no SSH tunnels or port forwarding required.

Does it work with Proxmox / Docker installs?

Yes. If you run HAOS, install it as an add-on. For Proxmox, Docker, or any other setup, run the standalone Docker container alongside your HA instance.

Is it safe?

Every file operation is path-validated to prevent writes outside allowed directories. Every change is Git-committed before and after, so you can always roll back. The agent uses your long-lived access token with the same permissions you configure.

Which IDEs are supported?

Any IDE that supports the MCP protocol: Claude Code, Cursor, VS Code (with GitHub Copilot), Windsurf, Codex, and others. The agent communicates over standard MCP, so new IDE support is automatic.

Do I need a cloud subscription?

No. The agent runs entirely on your local network. You only need an AI provider API key (Anthropic, OpenAI, etc.) configured in your IDE, which you likely already have.