Homebridge LLM Control

What This Plugin Does

Lets you message Homebridge like a person and get things done
Controls what Homebridge already exposes (lights, switches, outlets, etc.)
Schedules one-shot actions (like “turn off all lights in 30 minutes”)
Runs health checks, daily monitoring, and watchdog investigations
Can run guardrailed “skills” (approved shell commands) when needed
Chat options: ntfy + Telegram (two-way) and Discord webhook (notifications)

btw: this plugin can only control devices that are present in Homebridge. If something only exists in the iOS Home app (native HomeKit) and is not exposed through a Homebridge plugin, it will not appear here.

If your “real” devices live only in HomeKit, you can add a HomeKit-to-Homebridge bridge. One option: homebridge-homekit-control (use carefully: importing devices can create duplicates and can confuse your Home app if you already have the same devices bridged elsewhere).

Setup (Fast)

Install the plugin, pick a chat channel, restart Homebridge, then talk to it. That’s it.

ntfy (recommended): enable ntfy, restart, subscribe to the topic shown in /status
Telegram: create a bot token, enable Telegram, restart, message the bot
Discord webhook: paste webhook URL for notifications (not interactive chat)

First message after a restart should be: “Hey it’s set up. Homebridge LLM Control is online.”

Talk To It (Natural Language)

These are good first messages to send:

What devices can you control right now?
Turn off all the lights.
Turn on all the lights at 30% brightness.
Turn off everything in 30 minutes.

Is Homebridge healthy? Anything broken?
What changed in the logs today?

If You Like Commands

/help
/status

/hb list
/hb on lights
/hb off lights
/hb schedule 30m off lights

/health
/watchdog

Common “Why Can’t You See My Devices?”

If /hb list looks empty, it’s not an LLM problem: Homebridge itself isn’t exposing those devices.
Fix is to add/configure the right Homebridge plugins so the devices show up in Homebridge.
If those devices are only in HomeKit, see the HomeKit import option above.

Recipes (Useful Stuff)

One-Shot Schedules

Turn off all the lights in 20 minutes.
Restart Homebridge in 2 hours.

Recurring Automations (LLM-Driven)

Runtime automations live inside this plugin. They are cron-based and can be created/removed in chat.

/automation list
/automation add Nightly lights off | 0 1 * * * | Turn off all lights and switches.
/automation add Morning check | 0 8 * * * | Give me a short health report and highlight anything unusual.
/automation toggle <id> off
/automation remove <id>

Daily Monitoring + Watchdog

Enable daily monitoring at 9:00am.
Enable the watchdog. If there is a critical error, investigate and notify me.

/config set monitoring.dailyMonitoringEnabled true
/config set monitoring.dailyMonitoringTime 09:00
/config set watchdog.enabled true

“Restart Homebridge Every 12 Hours”

Restart Homebridge every 12 hours and notify me when it restarts.

/config set operations.scheduledRestartEnabled true
/config set operations.restartEveryHours 12
/config set operations.notifyOnHomebridgeRestart true

One-Off Scripts (Guardrailed Skills)

Skills are approved shell commands. They’re how you do powerful one-offs without giving an LLM unlimited shell access.

/skills
/skill propose Restart Homebridge | sudo hb-service restart | 60
/skill pending
/skill approve <proposalId> yes
/run <skillId>

Safety: skills run only from an allowlist, with cooldowns/quotas. Your chat token is effectively admin access.

Links

GitHub repo: theos2node/homebridge-llm-control
npm package: homebridge-llm-control
HomeKit import (optional): minamoanes/homebridge-homekit-control