HA NOVA — One code to connect.
Every change checked.

HA NOVA connects your AI coding assistant to Home Assistant — with a safety workflow that previews, confirms, and verifies every change.

Get started View on GitHub

Three steps, one code

No terminal expertise needed. The installer and the wizard do the wiring; a one-time code does the trust.

  1. Run the installer. One command for macOS, Linux, or Windows. The wizard finds your Home Assistant and sets up the NOVA Relay App.
  2. Connect a device 428 316 Connect a device. On the NOVA page in your Home Assistant sidebar; the wizard opens it at the right spot for you.
  3. Enter the code. One-time, expires in minutes. Your assistant is paired individually, revocable anytime from NOVA.

What you can do

You talk to the assistant you already use. HA NOVA does the careful part.

“Check my automations for problems”

Audits against 40+ rules — catches conflicts, dead triggers, and mistakes you’d never spot manually.

“Why didn’t my motion light trigger last night?”

Replays the actual trace and shows exactly where it failed and why.

“Turn on the porch light at sunset and off at 11 PM”

Builds, previews, and reviews the automation before it touches your config.

“What happened to my living room temperature overnight?”

Pulls history and summarizes the timeline in plain language.

“Add a weather card to my main dashboard”

Reads the dashboard, shows the change, writes only after you confirm.

Safe by design

Safety is the product, not a setting. Every change runs the same workflow.

  1. Researches first

    Reads your real entities, automations, and traces before proposing anything. No guessing.

  2. Shows the exact change

    You see the precise diff before a single byte is written.

  3. You approve

    Nothing is written without your yes, and deletes need a specific confirmation code.

  4. Writes and verifies

    Applies the change, then checks that what landed is what you approved.

  5. Audits itself

    Reviews its own work afterwards: mistakes, conflicts, reliability issues.

  6. Offers a safe test

    After saving an automation or script, you get a test plan matched to the risk — from a zero-impact logic check to a real run that names which devices will switch before you say go.

  7. Offers a way back

    Reply revert to undo the latest verified update. Where no automatic revert exists, HA NOVA says so before writing.

Ground rules

An optional installation census exists: off by default, strictly opt-in, and it can be switched off again anytime.

At home and away Beta

Local access stays first; your own Home Assistant Cloud subscription becomes the automatic fallback — no manual URL switching, and credentials stay in your OS’s native credential store. Requires HA OS or Supervised with Remote UI enabled and a desktop session; Container, Core, and headless setups stay local-only.

Home Assistant Cloud Your machine Home Assistant
Local stays first; cloud is the automatic fallback (Beta).

How it works

A lean NOVA Relay runs as an App on your Home Assistant server and is the only component that talks to Home Assistant. Everything the AI knows lives in readable markdown skills on your machine. The relay stays dumb; the skills stay smart.

Your machine Skills NOVA Relay 428 316 Home Assistant
The relay stays dumb; the skills stay smart.

Skills, not a tool server

A typical tool server pushes its whole catalog into your assistant by default. HA NOVA hands it one skill, on demand: a markdown file you can open and read.

The whole catalog, by default.
One skill, on demand.

Get started

You need Home Assistant — any install type. HA OS and Supervised get the NOVA Relay App via the wizard; Container and Core run the same relay as a standalone container with a token-based setup.

macOS / Linux

curl -fsSL https://raw.githubusercontent.com/markusleben/ha-nova/main/install.sh | bash

Windows (PowerShell)

irm https://raw.githubusercontent.com/markusleben/ha-nova/main/install.ps1 | iex

Works with

Actively developed — back up your configs before letting AI touch anything.