ha-setup-house

Set Up Your House

Guided build-out of your Home Assistant house structure. Each step runs existing ha-agent-lab commands; no new subsystem. Every write is gated by ha_safety_mode (strict = proposal, ask = native approval).

Steps

1. Take inventory

Run all four in parallel and present a summary:

${CLAUDE_PLUGIN_ROOT}/bin/ha-agent-lab ha list-areas
${CLAUDE_PLUGIN_ROOT}/bin/ha-agent-lab ha list-entities --registry
${CLAUDE_PLUGIN_ROOT}/bin/ha-agent-lab ha list-devices
${CLAUDE_PLUGIN_ROOT}/bin/ha-agent-lab ha list-helpers

Report:

• Number of areas, entities, devices, and helpers found
• Entities with no area assigned (unplaced)
• Devices with no area assigned (unplaced)
• Whether a context snapshot exists at .hermit/raw/snapshot-ha-normalized-latest.json

2. Create areas

Ask: "Which rooms or zones would you like to create? (e.g. Living Room, Kitchen, Bedroom 1)"

For each area the operator names:

1. Check the list-areas output — skip if the area already exists (case-insensitive match on name).
2. Preview the target, then run: ${CLAUDE_PLUGIN_ROOT}/bin/ha-agent-lab ha create-area "<name>"
3. Handle the result:
   • "ok": true — created; confirm to operator.
   • "blocked": true — ha_safety_mode is strict; explain and create a proposal via /hermitd:proposal-create.

After creating all areas, re-run ha list-areas and store the updated area map.

3. Assign unplaced entities

From the unplaced entity list (step 1), ask the operator which entities to assign and to which area.

For each assignment:

${CLAUDE_PLUGIN_ROOT}/bin/ha-agent-lab ha set-entity-area <entity_id> --area <area_id>

Use the area_id from the list-areas output, not the display name.

Handle success and policy refusal the same as step 2.

4. Assign unplaced devices

From the unplaced device list (step 1), follow the same pattern:

${CLAUDE_PLUGIN_ROOT}/bin/ha-agent-lab ha set-device-area <device_id> --area <area_id>

5. Provision helpers