How do I install the Ha Supervisor skill?

Run npx skillmds@latest add beclab/ha-supervisor in your terminal (requires Node.js), paste this page's agent-chat prompt into Claude, Cursor, or any MCP-connected agent, or download the SKILL.md file and copy it into your agent's skills directory.

Is Ha Supervisor safe to use?

This skill has not completed SkillMD's automated safety review yet. SkillMD never runs a skill's scripts for you; review the SKILL.md before installing.

Which AI agents work with Ha Supervisor?

This skill is tagged as working with Claude Code, Claude.ai, OpenAI Codex. SKILL.md is an open format, so most agents that read a skills directory can load it too.

Is Ha Supervisor free to use?

Yes. Installing skills from SkillMD is free, and the skill stays under its author's original license.

Who published Ha Supervisor?

beclab (@beclab) published this skill. Their other Agent Skills are listed on their SkillMD profile.

Ha Supervisor by beclab — Agent Skill

Name: Ha Supervisor
Author: beclab

Ha Supervisor

Manage Home Assistant add-ons and the Supervisor/OS layer with hass-cli. Use to list/install/uninstall/update/start/stop/restart add-ons, browse the add-on store, read add-on logs, or check Core/Supervisor/OS info. Works through Core's supervisor/api WebSocket proxy with a regular admin token (no separate supervisor token needed).

beclab 5902b3a 2.5 KB Updated Sep 17, 2026

File contents

ha-supervisor

Add-ons and the Supervisor/OS layer. Prerequisite: ../ha-shared/SKILL.md.

Availability: these only work on Supervised / HA OS installs. On a Core (Container) install there is no Supervisor and the commands fail fast with "this Home Assistant instance has no Supervisor". A regular admin HASS_TOKEN is enough — Core proxies Supervisor calls via the supervisor/api WebSocket command. If the token is not an admin, the CLI reports that you need an admin long-lived token.

Typed commands (preferred)

hass-cli addon list                     # installed add-ons
hass-cli addon info core_mosquitto
hass-cli addon start  core_mosquitto
hass-cli addon stop   core_mosquitto
hass-cli addon restart core_mosquitto
hass-cli addon logs   core_mosquitto

hass-cli supervisor info                # supervisor/host/os/core info
hass-cli supervisor stats               # supervisor cpu/memory usage
hass-cli supervisor host
hass-cli supervisor os
hass-cli supervisor core

Add-on lifecycle via Core services (also works)

hass-cli service call hassio.addon_start   --data '{"addon":"core_mosquitto"}'
hass-cli service call hassio.addon_restart --data '{"addon":"core_mosquitto"}'
hass-cli service call hassio.addon_stop    --data '{"addon":"core_mosquitto"}'
hass-cli service call hassio.backup_full

Anything else (raw Supervisor proxy)

For endpoints without a typed command (install/uninstall/update, options, store):

hass-cli raw ws supervisor/api --data '{"endpoint":"/store/addons/core_mosquitto/install","method":"post"}'
hass-cli raw ws supervisor/api --data '{"endpoint":"/addons/core_mosquitto/options","method":"post","data":{"options":{}}}'
hass-cli raw ws supervisor/api --data '{"endpoint":"/store","method":"get"}'

Notes

Add-ons also surface as entities (switch to start/stop, sensors for cpu/mem, update.* for available updates) — see ha-states / update entities.
HASS_SUPERVISOR_TOKEN is reserved for direct Supervisor access when Core is down; the typed/proxy paths above use the normal HASS_TOKEN.

---name: ha-supervisordescription: Manage Home Assistant add-ons and the Supervisor/OS layer with hass-cli. Use to list/install/uninstall/update/start/stop/restart add-ons, browse the add-on store, read add-on logs, or check Core/Supervisor/OS info. Works through Core's supervisor/api WebSocket proxy with a regular admin token (no separate supervisor token needed).---# ha-supervisorAdd-ons and the Supervisor/OS layer. **Prerequisite:**[`../ha-shared/SKILL.md`](../ha-shared/SKILL.md).> Availability: these only work on **Supervised / HA OS** installs. On a Core> (Container) install there is no Supervisor and the commands fail fast with> "this Home Assistant instance has no Supervisor". A regular **admin**> `HASS_TOKEN` is enough — Core proxies Supervisor calls via the> `supervisor/api` WebSocket command. If the token is not an admin, the CLI> reports that you need an admin long-lived token.## Typed commands (preferred)```bashhass-cli addon list # installed add-onshass-cli addon info core_mosquittohass-cli addon start core_mosquittohass-cli addon stop core_mosquittohass-cli addon restart core_mosquittohass-cli addon logs core_mosquittohass-cli supervisor info # supervisor/host/os/core infohass-cli supervisor stats # supervisor cpu/memory usagehass-cli supervisor hosthass-cli supervisor oshass-cli supervisor core```## Add-on lifecycle via Core services (also works)```bashhass-cli service call hassio.addon_start --data '{"addon":"core_mosquitto"}'hass-cli service call hassio.addon_restart --data '{"addon":"core_mosquitto"}'hass-cli service call hassio.addon_stop --data '{"addon":"core_mosquitto"}'hass-cli service call hassio.backup_full```## Anything else (raw Supervisor proxy)For endpoints without a typed command (install/uninstall/update, options, store):```bashhass-cli raw ws supervisor/api --data '{"endpoint":"/store/addons/core_mosquitto/install","method":"post"}'hass-cli raw ws supervisor/api --data '{"endpoint":"/addons/core_mosquitto/options","method":"post","data":{"options":{}}}'hass-cli raw ws supervisor/api --data '{"endpoint":"/store","method":"get"}'```## Notes- Add-ons also surface as entities (switch to start/stop, sensors for cpu/mem, `update.*` for available updates) — see `ha-states` / `update` entities.- `HASS_SUPERVISOR_TOKEN` is reserved for direct Supervisor access when Core is down; the typed/proxy paths above use the normal `HASS_TOKEN`.

Frequently asked questions