L
lexijamesesq/home-assistant-tools
Claude Code skills for managing a Home Assistant instance — update lifecycle, theme maintenance, dashboard validation
更新 2026-11-19
在 GitHub 查看 ↗链接已于 2026-11-17 核查 · HTTP 200 · 打开的是厂商自己的官网
- ★ 数取值
- 0 ★ · lexijamesesq/home-assistant-tools · 取自 GitHub 搜索 API · (2026-11-19 20:00:48 核对)
- 来源明细
- 从该仓库的 GitHub 页面直接读取 · 条目类型:开源项目
- 收录与活跃
- 收录于 2026-11-15 · 最近见到 2026-11-20 · 共见到 6 次 · 被 1 个来源列出
- 评分构成
- 综合分 103 · 1 个来源 · repo
常见问题(答案都来自我们的记录)
它适合谁 / 用来做什么?
我们把它归在这些标签下: 开源项目。标签来自条目自身,不是我们强加的分类。
谁维护它、还在更新吗?
仓库
lexijamesesq/home-assistant-tools;我们收录于 2026-11-15;最近见到 2026-11-20。这里没有"官方认证"或"质量评级"——我们只记录来源与时间。README 原文(英文,未翻译) · 在 GitHub 读完整 README →
# Home Assistant tools
以下摘录自该仓库的 README(片段)
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
收录徽章(可选)
想把收录标记放进 README 就复制这行,可选,不影响收录。
[](https://anclum.com/zh/s/lexijamesesq-home-assistant-tools/)
- 来源
- github · https://github.com/lexijamesesq/home-assistant-tools
- 按领域浏览
- 开源项目
- 收录于
- 今天
更多条目
所属领域与标签
每个标签都能点进去看同类的全部条目。数字是当前库里的真实条数。