Goal: Install a custom HACS integration to monitor temperature settings, control superfrost/supercool, and query status variables for Liebherr Combi appliances.
Why CLI Scripts? (Agentic AI Observability)
Before jumping into the script code, it is important to understand why command-line scripts are extremely useful for modern smart homes. Beyond convenience for terminal users, these CLI scripts act as a programmatic interface (API bridge) for agentic AI assistants like Antigravity (agy).
By exposing Home Assistant states through standard shell scripts, an AI agent running in your workspace can query, check, and verify live IoT metrics or network states autonomously. This enables the agent to check if the network is healthy, read environment levels, or verify configurations without having to scrape web-based dashboards or utilize complex browser interfaces. It bridges human developer terminal workflows with agentic automation.
Step-by-Step Configuration
1. Setup Custom Repository in HACS
- Open Home Assistant, go to HACS -> Integrations.
- Click the 3 dots in the top-right corner -> Custom Repositories.
- Add the Liebherr API repository:
https://github.com/iluvdata/liebherrand select Integration. - Download the custom integration and restart Home Assistant.
2. Retrieve your SmartDevice API Key
- Register your appliance on the Liebherr SmartDevice portal.
- Retrieve the API token key from your account settings (e.g.
01bf5......). - Add the Liebherr integration in Home Assistant Settings and input your API key.
3. Querying & Controlling Zones
Once added, the fridge registers several entities mapping to cooling zones:
# Querying current top zone (fridge) temperature
$ /home/gvoina/scripts/get_ha_sensor.sh sensor.zorilor_top_zone
Top zone: 5 °C
# Querying current bottom zone (freezer) temperature
$ /home/gvoina/scripts/get_ha_sensor.sh sensor.zorilor_bottom_zone
Bottom zone: -18 °CYou can also toggle switch.zorilor_partymode or switch.zorilor_nightmode directly from your automations!
