Skip to content
kevinbossPublic

About

Scriptable command-line interface for Home Assistant

Topics

Resources

Stars

0 stars

Watchers

0 watching

Forks

Latest commit

 

History

91 Commits

Folders and files

Repository files navigation

Haus

Scriptable command-line interface for Home Assistant.

.NET Scoop AUR winget CI License Heartbeat

This project is being developed using AI development tools. However, every line of code is reviewed and approved by a human before being committed.

haus demo

Install

Scoop

scoop bucket add maple 'https://github.com/kevinboss/maple.git'
scoop install haus

Winget

winget install kevinboss.haus

AUR

yay -S haus-bin

Manual

Grab a binary (Windows or Linux x64) from the releases page and put it on your PATH.

Usage

# Authenticate
haus login

# List entities
haus state list

# Get entity details
haus state get light.kitchen

# Call a service
haus service call light.turn_on --entity light.kitchen

# View automation config
haus automation get automation.morning_routine

# Toggle an automation
haus automation toggle automation.morning_routine

# Create a new automation from a JSON file (avoids shell-quoting Jinja)
haus automation create --from-file morning.json

# Create a reusable script (e.g. fan out notifications to multiple phones)
haus script create --id notify_all_phones --from-file notify_all.json

# List Lovelace dashboards (and edit their view config via JSON)
haus dashboard list
haus dashboard config get my-dashboard --json > config.json
haus dashboard config save my-dashboard --from-file config.json

# List the entity registry (includes disabled/hidden entities)
haus entity list

# Disable a noisy entity
haus entity update sensor.unused --disable

# Manage areas (Settings → Areas & Zones)
haus area list
haus area create --name "Living Room" --icon mdi:sofa
haus area update living_room --floor ground_floor

# Labels: create once, bulk-assign across many entities/areas
haus label create --name "Critical" --color red --icon mdi:alert
haus label assign critical --entity sensor.front_door --entity sensor.back_door --area garage

# Apply config changes without a full restart
haus hass reload automation
haus hass restart

# Check for available updates
haus update list

# Install an update
haus update install update.home_assistant_core_update

# List integrations (config entries) and tweak their options
haus integration list
haus integration get 01KKCVMQESC1RV1YQ39ANVHT78          # entry details + options schema
haus integration configure 01KKCVMQESC1RV1YQ39ANVHT78 --data '{"notify": [], ...}'
haus integration reload 01KKCVMQESC1RV1YQ39ANVHT78         # the UI's reload button
haus integration disable 01KKCVMQESC1RV1YQ39ANVHT78        # unload without deleting (enable to restore)
haus integration reauth 01K68HW3ZFF0B0X3XQ0ZZKNYJP         # complete a pending reauth (fixes 401s)
haus integration reconfigure 01K68HW3ZFF0B0X3XQ0ZZKNYJP    # change host/credentials proactively

# See what Home Assistant wants you to fix (Settings → Repairs)
haus repair list
haus repair get spook empty_areas_toilet                   # details + the integration's issue data
haus repair fix spook empty_areas_toilet                   # runs the fix flow; confirm-only repairs apply at once
haus repair ignore spook empty_areas_toilet                # dismiss it instead

# See what just changed (logbook entries from the last hour)
haus logbook list

# Filter logbook to a single entity
haus logbook list --entity automation.morning_routine --since 1d

# State history for an entity
haus history get device_tracker.phone --since 6h

# Validate Home Assistant configuration
haus config check

# Show recent errors and warnings
haus log --limit 10
haus log --level error

# Install the Haus skill into Claude Code
haus skill install

# Scriptable output
haus state list --porcelain | grep automation
haus state get sensor.temp --json

All commands support --json for structured output and --porcelain for plain tab-separated text.

Build

dotnet build
dotnet run --project src/Haus -- <command>
dotnet test

License

GPL-3.0

About

Scriptable command-line interface for Home Assistant

Topics

Resources

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages