Home Assistant Local Ops Kit

A lightweight toolkit for managing a Home Assistant OS instance from your terminal.

What It Does

• Query Home Assistant entities/services via REST API
• Pull/push /config over SSH
• Run remote ha core check and ha core restart
• Provide a safe local workflow for editing HA config

Included

• tools/ha_api.py - API helper (ping, config, services, entities)
• tools/ha_config_sync.sh - SSH-based config sync and HA control
• HA_AGENT_RUNBOOK.md - practical workflow and safety notes
• .env.example - required env vars template

Quick Start

1. Copy env template:
   • cp .env.example .env
2. Fill in .env with your HA URL, token, and SSH details.
3. Load env:
   • set -a; source .env; set +a
4. Validate access:
   • python3 tools/ha_api.py ping
5. Pull config mirror:
   • tools/ha_config_sync.sh pull

Typical Workflow

1. Pull latest HA config to ./ha-config
2. Edit locally
3. Push config
4. Run ha core check
5. Restart HA only if check passes

Security

• .env is git-ignored
• Keep long-lived tokens and passwords out of committed files