i've been developing and using this for myself for the past two years, today I decide to refactor and document it so it could be shared with others, maybe you'll find this useful too

this tool connects to HA via websocket and mqtt and gives you a clean api to read state, call services, track changes, build automation pipelines and also create custom mqtt devices with sensors, switches, buttons, etc. that show up in HA through auto-discovery

some things it does:

- state tracking with hold timers that fire only if a state holds for X minutes, auto-cancel if it reverts
- chainable automation builder with conditions, waits, branching, and re-trigger cancellation (motion light that resets on new motion, etc.)
- mqtt device creation, you can spin up sensors, switches, selects, numbers, binary sensors, buttons, all namespaced so you can run multiple instances
- built-in http server (hono) with support for authorization, webhooks, json-rpc, and custom routes
- auto-reconnect, it handles HA restarts, re-publishes MQTT discovery on reconnect

quick example of an automation:

```
sk.automation("hallway motion light")
  .trigger.stateTo("binary_sensor.motion", "on")
  .turnOn("light.hallway")
  .wait(minutes(10))
  .turnOff("light.hallway");
```

idk, if you like writing automations in code instead of yaml, it might be your thing, i also use this to easily integrate web services and other stuff that don't have HA integrations

oh, and it's not on npm because i'm lazy

hass-sidekick | TypeScript library for writing Home Assistant automations in code and more