L
lexijamesesq/home-assistant-tools
Claude Code skills for managing a Home Assistant instance — update lifecycle, theme maintenance, dashboard validation
updated 2026-11-19
View on GitHub ↗Link checked 2026-11-17 · HTTP 200 · opens the vendor's own site
- Star count
- 0 ★ · lexijamesesq/home-assistant-tools · read from the GitHub search API · (checked 2026-11-19 20:00:48)
- Source
- read directly from its GitHub page · type: open-source project
- Harvest history
- first seen 2026-11-15 · last seen 2026-11-20 · seen 6× · listed by 1 sources
- Score
- score 103 · 1 sources · repo
FAQ (answers come from our records)
Who is it for?
We filed it under these tags: Open Source. The tags come from the entry itself, not a taxonomy we imposed.
Who maintains it?
repository
lexijamesesq/home-assistant-tools;first catalogued 2026-11-15;last seen 2026-11-20。There is no official certification or quality rating here — we record sources and dates only.README excerpt (English, untranslated) · Read the full README on GitHub →
# Home Assistant tools
Excerpted from the repository README (abridged)
Claude Code skills for managing a Home Assistant instance. Handles system updates, theme maintenance, and dashboard validation through SSH and the HA MCP server — designed to run from a Mac managing a remote HA OS installation.
## Installation
Clone the repo. .claude/ ships tracked and committed — review its contents (see Security below) before opening the directory in Claude Code.
Copy the instance config sample and fill in your values:
text
cp .claude/instance.sample.md .claude/instance.md
### Required configuration
| Field | Location | What to set |
| ssh.host | .claude/instance.md > Configuration | SSH user@host for your HA instance (e.g., root@10.0.40.20) |
| ssh.key | .claude/instance.md > Configuration | Path to your SSH private key |
| ssh.config_path | .claude/instance.md > Configuration | HA config directory on the remote host (usually /config) |
| ha.local_url | .claude/instance.md > Configuration | Local URL for your HA instance (e.g., http://homeassistant.local:8123) |
### Optional configuration
| Field | Location | What to set |
| addons.mcp_server_slug | .claude/instance.md > Configuration | Supervisor slug for the MCP Server add-on (needed for the bootstrap workaround in /ha-update) |
| dashboard.name | .claude/instance.md > Configuration | Your primary dashboard URL path (e.g., dashboard-home) |
| dashboard.views | .claude/instance.md > Configuration | List of view names for /visual-diff screenshot captures |
### Dependencies
Home Assistant OS with SSH access (Terminal & SSH add-on, key auth)
Home Assistant MCP Server add-on installed and configured as a Claude Code MCP server
Chrome MCP for browser automation (used by /visual-diff and /theme-update)
## What's Included
### Skills
| Skill | What it does |
| /ha-update | Full update lifecycle — inventories pending updates, classifies risk using learned heuristics, determines safe execution order, installs updates with validation gates, and refines its heuristics after each run. Handles Core, add-ons, HACS, and OS updates. Runs autonomously. |
| /theme-update | Merges a new Catppuccin distribution release into a customized Mush theme fork, preserving aesthetic overrides and applying HA 2026.x compatibility fixes (ramp flip, modes injection removal). |
| /visual-diff | Captures before/after screenshots of dashboard views for visual validation. Used by /theme-update and available standalone for any UI change. |
### Supporting files (not tracked — create your own)
| File | What it does |
| Knowledge/Methods/update-heuristics.md | Distilled patterns /ha-update learns from each run — risk overrides, dependency patterns, validation checks, known gotchas |
| Knowledge/Reference/theme-architecture.md | Reference doc for the Catppuccin Mush theme — ramp direction, modes injection, override markers |
| Eval/ | Test suites for validating HA subsystems after updates (brightness, Sonos, etc.) |
| Context/ | Design docs and implementation specs for backlog items |
## Configuration
The system separates what you configure from what skills handle.
You configure:
.claude/instance.md — SSH connection details, HA URLs, add-on slugs, dashboard views
Knowledge/Methods/update-heuristics.md — starts empty, grows as /ha-update learns your system
## Installation
Clone the repo. .claude/ ships tracked and committed — review its contents (see Security below) before opening the directory in Claude Code.
Copy the instance config sample and fill in your values:
text
cp .claude/instance.sample.md .claude/instance.md
### Required configuration
| Field | Location | What to set |
| ssh.host | .claude/instance.md > Configuration | SSH user@host for your HA instance (e.g., root@10.0.40.20) |
| ssh.key | .claude/instance.md > Configuration | Path to your SSH private key |
| ssh.config_path | .claude/instance.md > Configuration | HA config directory on the remote host (usually /config) |
| ha.local_url | .claude/instance.md > Configuration | Local URL for your HA instance (e.g., http://homeassistant.local:8123) |
### Optional configuration
| Field | Location | What to set |
| addons.mcp_server_slug | .claude/instance.md > Configuration | Supervisor slug for the MCP Server add-on (needed for the bootstrap workaround in /ha-update) |
| dashboard.name | .claude/instance.md > Configuration | Your primary dashboard URL path (e.g., dashboard-home) |
| dashboard.views | .claude/instance.md > Configuration | List of view names for /visual-diff screenshot captures |
### Dependencies
Home Assistant OS with SSH access (Terminal & SSH add-on, key auth)
Home Assistant MCP Server add-on installed and configured as a Claude Code MCP server
Chrome MCP for browser automation (used by /visual-diff and /theme-update)
## What's Included
### Skills
| Skill | What it does |
| /ha-update | Full update lifecycle — inventories pending updates, classifies risk using learned heuristics, determines safe execution order, installs updates with validation gates, and refines its heuristics after each run. Handles Core, add-ons, HACS, and OS updates. Runs autonomously. |
| /theme-update | Merges a new Catppuccin distribution release into a customized Mush theme fork, preserving aesthetic overrides and applying HA 2026.x compatibility fixes (ramp flip, modes injection removal). |
| /visual-diff | Captures before/after screenshots of dashboard views for visual validation. Used by /theme-update and available standalone for any UI change. |
### Supporting files (not tracked — create your own)
| File | What it does |
| Knowledge/Methods/update-heuristics.md | Distilled patterns /ha-update learns from each run — risk overrides, dependency patterns, validation checks, known gotchas |
| Knowledge/Reference/theme-architecture.md | Reference doc for the Catppuccin Mush theme — ramp direction, modes injection, override markers |
| Eval/ | Test suites for validating HA subsystems after updates (brightness, Sonos, etc.) |
| Context/ | Design docs and implementation specs for backlog items |
## Configuration
The system separates what you configure from what skills handle.
You configure:
.claude/instance.md — SSH connection details, HA URLs, add-on slugs, dashboard views
Knowledge/Methods/update-heuristics.md — starts empty, grows as /ha-update learns your system
Listed badge (optional)
Copy this line into the README if you want the listing mark. Optional, and it does not affect being listed.
[](https://anclum.com/en/s/lexijamesesq-home-assistant-tools/)
- Source
- github · https://github.com/lexijamesesq/home-assistant-tools
- Browse by field
- Open source
- added
- today
More entries
Filed under
Every tag opens the full list for that filter. Counts are the live catalogue figures.