---
name: home-assistant-bridge
description: "Read the Home Assistant Bridge docs instead of answering from memory. One shared Home Assistant connection for your machine, served to local apps over a single socket. Use when a task involves Home Assistant Bridge: how it works, how to set it up or configure it, or its API."
---

# Home Assistant Bridge

One shared Home Assistant connection for your machine, served to local apps over a single socket.

This skill points you at the Home Assistant Bridge docs, at https://ha-bridge.timmo.dev/. When a task involves Home Assistant Bridge, read the relevant page before relying on what you remember: the docs are the source of truth, and they change.

## Reading the docs

- Any page as Markdown: add `.md` to its URL (the home page is https://ha-bridge.timmo.dev/index.md). Every page link below already points at the Markdown.
- [llms.txt](https://ha-bridge.timmo.dev/llms.txt): every page with a one-line summary.
- [llms-full.txt](https://ha-bridge.timmo.dev/llms-full.txt): every page in one file, for when you need all of it.
- MCP server at https://ha-bridge.timmo.dev/mcp, with `search_docs`, `get_page`, `list_pages`, and `get_navigation`. Connect it to search the docs instead of guessing URLs.
- [JSON API](https://ha-bridge.timmo.dev/api/docs/pages.json): the page index, with each page as JSON and Markdown.

## Pages

- [Overview](https://ha-bridge.timmo.dev/index.md): One shared Home Assistant connection for your machine, served to local apps over a single socket.
- [Install](https://ha-bridge.timmo.dev/install.md): Install Home Assistant Bridge from the timmo pacman repository, a Debian or RPM package, or a release archive.
- [Configuration](https://ha-bridge.timmo.dev/configuration.md): Point Home Assistant Bridge at your Home Assistant URL and a long-lived access token.
- [Running the bridge](https://ha-bridge.timmo.dev/running.md): Run Home Assistant Bridge as a systemd user service, read its logs and keep it running.
- [Libraries](https://ha-bridge.timmo.dev/libraries.md): Use the bridge, or Home Assistant directly, from your own Effect app.
- [Agent skills](https://ha-bridge.timmo.dev/agent-skills.md): Teach coding agents to use ha-bridge, and to read these docs, with Agent Skills.

### Actions

- [Actions](https://ha-bridge.timmo.dev/actions.md): Control Home Assistant entities from the command line, one action per command.
- [Lights](https://ha-bridge.timmo.dev/actions/lights.md): Turn lights on and off, and set brightness, colour, effects and transitions.
- [Switches](https://ha-bridge.timmo.dev/actions/switches.md): Turn switches on and off.
- [Input booleans](https://ha-bridge.timmo.dev/actions/input-booleans.md): Turn input boolean helpers on and off, and reload them from YAML.
- [Input numbers](https://ha-bridge.timmo.dev/actions/input-numbers.md): Set input number helpers, step them up or down, and reload them from YAML.
- [Covers](https://ha-bridge.timmo.dev/actions/covers.md): Open, close and stop covers, set their position and control their tilt.
- [Climate](https://ha-bridge.timmo.dev/actions/climate.md): Turn climate entities on and off, and set their HVAC mode, temperature, humidity and other modes.
- [Assist satellites](https://ha-bridge.timmo.dev/actions/assist-satellites.md): Announce messages, start conversations and ask questions on Assist satellites.
- [Cameras](https://ha-bridge.timmo.dev/actions/cameras.md): Save camera snapshots, record clips, play streams and switch motion detection.
- [Buttons](https://ha-bridge.timmo.dev/actions/buttons.md): Press buttons and input button helpers, and reload input buttons from YAML.
- [Locks](https://ha-bridge.timmo.dev/actions/locks.md): Lock, unlock and open locks.
- [Valves](https://ha-bridge.timmo.dev/actions/valves.md): Open, close and stop valves, and set their position.
- [Sirens](https://ha-bridge.timmo.dev/actions/sirens.md): Turn sirens on and off, with a tone, duration and volume.
- [Remotes](https://ha-bridge.timmo.dev/actions/remotes.md): Turn remotes on and off, send commands, and learn or delete commands.
- [Selects](https://ha-bridge.timmo.dev/actions/selects.md): Pick options on select entities and input select helpers.
- [Numbers, text, dates and times](https://ha-bridge.timmo.dev/actions/values.md): Set the value of number, text, date, time and datetime entities and their input helpers.
- [Counters](https://ha-bridge.timmo.dev/actions/counters.md): Step counters up and down, reset them or set a count.
- [Scripts](https://ha-bridge.timmo.dev/actions/scripts.md): Start, stop and run scripts, with variables and responses, and read and change their configs.
- [Automations](https://ha-bridge.timmo.dev/actions/automations.md): Turn automations on and off, trigger them, reload them, and read and change their configs.
- [Scenes](https://ha-bridge.timmo.dev/actions/scenes.md): Activate scenes, apply entity states, and create or delete scenes on the fly.
- [Timers and schedules](https://ha-bridge.timmo.dev/actions/timers.md): Start, pause, change and finish timers, and read schedules.
- [Groups](https://ha-bridge.timmo.dev/actions/groups.md): Create, change and remove old-style groups.
- [Fans](https://ha-bridge.timmo.dev/actions/fans.md): Turn fans on and off and set their speed, preset, oscillation and direction.
- [Humidifiers and water heaters](https://ha-bridge.timmo.dev/actions/humidifiers.md): Control humidifiers and water heaters.
- [Media players](https://ha-bridge.timmo.dev/actions/media-players.md): Control playback, volume, sources and grouping on media players, and browse or search their media.
- [Vacuums and lawn mowers](https://ha-bridge.timmo.dev/actions/vacuums.md): Start, pause and dock vacuums and lawn mowers, and clean areas.
- [Alarm panels](https://ha-bridge.timmo.dev/actions/alarms.md): Arm, disarm and trigger alarm control panels.
- [Updates](https://ha-bridge.timmo.dev/actions/updates.md): Install or skip updates.
- [Notifications and speech](https://ha-bridge.timmo.dev/actions/notifications.md): Send notifications, show persistent notifications in Home Assistant and speak messages on media players.
- [To-do lists](https://ha-bridge.timmo.dev/actions/todo-lists.md): Read, add, change and remove to-do list items.
- [Calendars and weather](https://ha-bridge.timmo.dev/actions/calendars.md): Read and add calendar events, and read weather forecasts.
- [Conversation and AI tasks](https://ha-bridge.timmo.dev/actions/conversation.md): Send text to conversation agents and generate data or images with AI tasks.
- [Images and device trackers](https://ha-bridge.timmo.dev/actions/images.md): Save image entities, run image processing and report legacy device tracker locations.
- [Alerts and utility meters](https://ha-bridge.timmo.dev/actions/alerts.md): Turn alerts on and off, and reset or calibrate utility meters.
- [System](https://ha-bridge.timmo.dev/actions/system.md): Write logs, set log levels, manage the recorder, set themes, back up, wake devices and manage cloud, FFmpeg and Google Assistant.
- [Supervisor](https://ha-bridge.timmo.dev/actions/supervisor.md): Start and stop apps, back up and restore, and reboot or shut down the host.
- [Shell, REST and Python commands](https://ha-bridge.timmo.dev/actions/commands.md): Run shell commands, REST commands and Python scripts configured in Home Assistant.
- [Home Assistant](https://ha-bridge.timmo.dev/actions/home-assistant.md): Control entities of any domain, restart Home Assistant and reload its configuration.

### Using

- [Reading entities](https://ha-bridge.timmo.dev/using/reading.md): Read or stream Home Assistant entity state into scripts and status bars through the bridge.
- [Searching](https://ha-bridge.timmo.dev/using/search.md): Find Home Assistant entities, devices and areas, and ha-bridge commands, with fuzzy search.
- [Templates](https://ha-bridge.timmo.dev/using/templates.md): Render Home Assistant templates once, or watch them as what they read changes.
- [Events, triggers and conditions](https://ha-bridge.timmo.dev/using/events.md): Watch and fire events, listen for automation triggers and check conditions.
- [History and logbook](https://ha-bridge.timmo.dev/using/history.md): Read recorded entity history and logbook entries, and watch new logbook entries.
- [Logs](https://ha-bridge.timmo.dev/using/logs.md): Read, watch and search Home Assistant's logs, from Core's errors to the Supervisor, host, plugins and apps.
- [Bar JSON](https://ha-bridge.timmo.dev/using/bar-json.md): The JSON lines that watchers print for status bars, shells and scripts.
- [Shell completions](https://ha-bridge.timmo.dev/using/completions.md): Tab completion for Home Assistant Bridge commands, aliases and flags in bash, zsh and fish.
- [Bridge protocol](https://ha-bridge.timmo.dev/using/protocol.md): The RPCs the bridge serves on its Unix socket, and their wire format.

### Commands

- [Commands](https://ha-bridge.timmo.dev/commands.md): Every Home Assistant Bridge command, alias, argument and flag, generated from the CLI's help.
- [ha-bridge serve](https://ha-bridge.timmo.dev/commands/serve.md): Arguments and flags for every ha-bridge serve command.
- [ha-bridge setup](https://ha-bridge.timmo.dev/commands/setup.md): Arguments and flags for every ha-bridge setup command.
- [ha-bridge get](https://ha-bridge.timmo.dev/commands/get.md): Arguments and flags for every ha-bridge get command.
- [ha-bridge watch](https://ha-bridge.timmo.dev/commands/watch.md): Arguments and flags for every ha-bridge watch command.
- [ha-bridge assist_satellite](https://ha-bridge.timmo.dev/commands/assist-satellite.md): Arguments and flags for every ha-bridge assist_satellite command.
- [ha-bridge input_boolean](https://ha-bridge.timmo.dev/commands/input-boolean.md): Arguments and flags for every ha-bridge input_boolean command.
- [ha-bridge input_number](https://ha-bridge.timmo.dev/commands/input-number.md): Arguments and flags for every ha-bridge input_number command.
- [ha-bridge light](https://ha-bridge.timmo.dev/commands/light.md): Arguments and flags for every ha-bridge light command.
- [ha-bridge switch](https://ha-bridge.timmo.dev/commands/switch.md): Arguments and flags for every ha-bridge switch command.
- [ha-bridge cover](https://ha-bridge.timmo.dev/commands/cover.md): Arguments and flags for every ha-bridge cover command.
- [ha-bridge climate](https://ha-bridge.timmo.dev/commands/climate.md): Arguments and flags for every ha-bridge climate command.
- [ha-bridge camera](https://ha-bridge.timmo.dev/commands/camera.md): Arguments and flags for every ha-bridge camera command.
- [ha-bridge button](https://ha-bridge.timmo.dev/commands/button.md): Arguments and flags for every ha-bridge button command.
- [ha-bridge input_button](https://ha-bridge.timmo.dev/commands/input-button.md): Arguments and flags for every ha-bridge input_button command.
- [ha-bridge lock](https://ha-bridge.timmo.dev/commands/lock.md): Arguments and flags for every ha-bridge lock command.
- [ha-bridge valve](https://ha-bridge.timmo.dev/commands/valve.md): Arguments and flags for every ha-bridge valve command.
- [ha-bridge siren](https://ha-bridge.timmo.dev/commands/siren.md): Arguments and flags for every ha-bridge siren command.
- [ha-bridge remote](https://ha-bridge.timmo.dev/commands/remote.md): Arguments and flags for every ha-bridge remote command.
- [ha-bridge select](https://ha-bridge.timmo.dev/commands/select.md): Arguments and flags for every ha-bridge select command.
- [ha-bridge input_select](https://ha-bridge.timmo.dev/commands/input-select.md): Arguments and flags for every ha-bridge input_select command.
- [ha-bridge number](https://ha-bridge.timmo.dev/commands/number.md): Arguments and flags for every ha-bridge number command.
- [ha-bridge text](https://ha-bridge.timmo.dev/commands/text.md): Arguments and flags for every ha-bridge text command.
- [ha-bridge input_text](https://ha-bridge.timmo.dev/commands/input-text.md): Arguments and flags for every ha-bridge input_text command.
- [ha-bridge date](https://ha-bridge.timmo.dev/commands/date.md): Arguments and flags for every ha-bridge date command.
- [ha-bridge time](https://ha-bridge.timmo.dev/commands/time.md): Arguments and flags for every ha-bridge time command.
- [ha-bridge datetime](https://ha-bridge.timmo.dev/commands/datetime.md): Arguments and flags for every ha-bridge datetime command.
- [ha-bridge input_datetime](https://ha-bridge.timmo.dev/commands/input-datetime.md): Arguments and flags for every ha-bridge input_datetime command.
- [ha-bridge counter](https://ha-bridge.timmo.dev/commands/counter.md): Arguments and flags for every ha-bridge counter command.
- [ha-bridge script](https://ha-bridge.timmo.dev/commands/script.md): Arguments and flags for every ha-bridge script command.
- [ha-bridge automation](https://ha-bridge.timmo.dev/commands/automation.md): Arguments and flags for every ha-bridge automation command.
- [ha-bridge scene](https://ha-bridge.timmo.dev/commands/scene.md): Arguments and flags for every ha-bridge scene command.
- [ha-bridge timer](https://ha-bridge.timmo.dev/commands/timer.md): Arguments and flags for every ha-bridge timer command.
- [ha-bridge schedule](https://ha-bridge.timmo.dev/commands/schedule.md): Arguments and flags for every ha-bridge schedule command.
- [ha-bridge group](https://ha-bridge.timmo.dev/commands/group.md): Arguments and flags for every ha-bridge group command.
- [ha-bridge homeassistant](https://ha-bridge.timmo.dev/commands/homeassistant.md): Arguments and flags for every ha-bridge homeassistant command.
- [ha-bridge fan](https://ha-bridge.timmo.dev/commands/fan.md): Arguments and flags for every ha-bridge fan command.
- [ha-bridge humidifier](https://ha-bridge.timmo.dev/commands/humidifier.md): Arguments and flags for every ha-bridge humidifier command.
- [ha-bridge water_heater](https://ha-bridge.timmo.dev/commands/water-heater.md): Arguments and flags for every ha-bridge water_heater command.
- [ha-bridge media_player](https://ha-bridge.timmo.dev/commands/media-player.md): Arguments and flags for every ha-bridge media_player command.
- [ha-bridge vacuum](https://ha-bridge.timmo.dev/commands/vacuum.md): Arguments and flags for every ha-bridge vacuum command.
- [ha-bridge lawn_mower](https://ha-bridge.timmo.dev/commands/lawn-mower.md): Arguments and flags for every ha-bridge lawn_mower command.
- [ha-bridge alarm_control_panel](https://ha-bridge.timmo.dev/commands/alarm-control-panel.md): Arguments and flags for every ha-bridge alarm_control_panel command.
- [ha-bridge update](https://ha-bridge.timmo.dev/commands/update.md): Arguments and flags for every ha-bridge update command.
- [ha-bridge notify](https://ha-bridge.timmo.dev/commands/notify.md): Arguments and flags for every ha-bridge notify command.
- [ha-bridge persistent_notification](https://ha-bridge.timmo.dev/commands/persistent-notification.md): Arguments and flags for every ha-bridge persistent_notification command.
- [ha-bridge tts](https://ha-bridge.timmo.dev/commands/tts.md): Arguments and flags for every ha-bridge tts command.
- [ha-bridge todo](https://ha-bridge.timmo.dev/commands/todo.md): Arguments and flags for every ha-bridge todo command.
- [ha-bridge calendar](https://ha-bridge.timmo.dev/commands/calendar.md): Arguments and flags for every ha-bridge calendar command.
- [ha-bridge weather](https://ha-bridge.timmo.dev/commands/weather.md): Arguments and flags for every ha-bridge weather command.
- [ha-bridge conversation](https://ha-bridge.timmo.dev/commands/conversation.md): Arguments and flags for every ha-bridge conversation command.
- [ha-bridge ai_task](https://ha-bridge.timmo.dev/commands/ai-task.md): Arguments and flags for every ha-bridge ai_task command.
- [ha-bridge image](https://ha-bridge.timmo.dev/commands/image.md): Arguments and flags for every ha-bridge image command.
- [ha-bridge image_processing](https://ha-bridge.timmo.dev/commands/image-processing.md): Arguments and flags for every ha-bridge image_processing command.
- [ha-bridge device_tracker](https://ha-bridge.timmo.dev/commands/device-tracker.md): Arguments and flags for every ha-bridge device_tracker command.
- [ha-bridge alert](https://ha-bridge.timmo.dev/commands/alert.md): Arguments and flags for every ha-bridge alert command.
- [ha-bridge utility_meter](https://ha-bridge.timmo.dev/commands/utility-meter.md): Arguments and flags for every ha-bridge utility_meter command.
- [ha-bridge logbook](https://ha-bridge.timmo.dev/commands/logbook.md): Arguments and flags for every ha-bridge logbook command.
- [ha-bridge system_log](https://ha-bridge.timmo.dev/commands/system-log.md): Arguments and flags for every ha-bridge system_log command.
- [ha-bridge logs](https://ha-bridge.timmo.dev/commands/logs.md): Arguments and flags for every ha-bridge logs command.
- [ha-bridge logger](https://ha-bridge.timmo.dev/commands/logger.md): Arguments and flags for every ha-bridge logger command.
- [ha-bridge recorder](https://ha-bridge.timmo.dev/commands/recorder.md): Arguments and flags for every ha-bridge recorder command.
- [ha-bridge frontend](https://ha-bridge.timmo.dev/commands/frontend.md): Arguments and flags for every ha-bridge frontend command.
- [ha-bridge backup](https://ha-bridge.timmo.dev/commands/backup.md): Arguments and flags for every ha-bridge backup command.
- [ha-bridge wake_on_lan](https://ha-bridge.timmo.dev/commands/wake-on-lan.md): Arguments and flags for every ha-bridge wake_on_lan command.
- [ha-bridge hassio](https://ha-bridge.timmo.dev/commands/hassio.md): Arguments and flags for every ha-bridge hassio command.
- [ha-bridge shell_command](https://ha-bridge.timmo.dev/commands/shell-command.md): Arguments and flags for every ha-bridge shell_command command.
- [ha-bridge rest_command](https://ha-bridge.timmo.dev/commands/rest-command.md): Arguments and flags for every ha-bridge rest_command command.
- [ha-bridge python_script](https://ha-bridge.timmo.dev/commands/python-script.md): Arguments and flags for every ha-bridge python_script command.
- [ha-bridge cloud](https://ha-bridge.timmo.dev/commands/cloud.md): Arguments and flags for every ha-bridge cloud command.
- [ha-bridge ffmpeg](https://ha-bridge.timmo.dev/commands/ffmpeg.md): Arguments and flags for every ha-bridge ffmpeg command.
- [ha-bridge google_assistant](https://ha-bridge.timmo.dev/commands/google-assistant.md): Arguments and flags for every ha-bridge google_assistant command.
- [ha-bridge lovelace](https://ha-bridge.timmo.dev/commands/lovelace.md): Arguments and flags for every ha-bridge lovelace command.
- [ha-bridge template](https://ha-bridge.timmo.dev/commands/template.md): Arguments and flags for every ha-bridge template command.
- [ha-bridge event](https://ha-bridge.timmo.dev/commands/event.md): Arguments and flags for every ha-bridge event command.
- [ha-bridge trigger](https://ha-bridge.timmo.dev/commands/trigger.md): Arguments and flags for every ha-bridge trigger command.
- [ha-bridge condition](https://ha-bridge.timmo.dev/commands/condition.md): Arguments and flags for every ha-bridge condition command.
- [ha-bridge history](https://ha-bridge.timmo.dev/commands/history.md): Arguments and flags for every ha-bridge history command.
- [ha-bridge bayesian](https://ha-bridge.timmo.dev/commands/bayesian.md): Arguments and flags for every ha-bridge bayesian command.
- [ha-bridge command_line](https://ha-bridge.timmo.dev/commands/command-line.md): Arguments and flags for every ha-bridge command_line command.
- [ha-bridge derivative](https://ha-bridge.timmo.dev/commands/derivative.md): Arguments and flags for every ha-bridge derivative command.
- [ha-bridge filter](https://ha-bridge.timmo.dev/commands/filter.md): Arguments and flags for every ha-bridge filter command.
- [ha-bridge generic_thermostat](https://ha-bridge.timmo.dev/commands/generic-thermostat.md): Arguments and flags for every ha-bridge generic_thermostat command.
- [ha-bridge history_stats](https://ha-bridge.timmo.dev/commands/history-stats.md): Arguments and flags for every ha-bridge history_stats command.
- [ha-bridge intent_script](https://ha-bridge.timmo.dev/commands/intent-script.md): Arguments and flags for every ha-bridge intent_script command.
- [ha-bridge min_max](https://ha-bridge.timmo.dev/commands/min-max.md): Arguments and flags for every ha-bridge min_max command.
- [ha-bridge person](https://ha-bridge.timmo.dev/commands/person.md): Arguments and flags for every ha-bridge person command.
- [ha-bridge rest](https://ha-bridge.timmo.dev/commands/rest.md): Arguments and flags for every ha-bridge rest command.
- [ha-bridge statistics](https://ha-bridge.timmo.dev/commands/statistics.md): Arguments and flags for every ha-bridge statistics command.
- [ha-bridge trend](https://ha-bridge.timmo.dev/commands/trend.md): Arguments and flags for every ha-bridge trend command.
- [ha-bridge universal](https://ha-bridge.timmo.dev/commands/universal.md): Arguments and flags for every ha-bridge universal command.
- [ha-bridge zone](https://ha-bridge.timmo.dev/commands/zone.md): Arguments and flags for every ha-bridge zone command.
- [ha-bridge search](https://ha-bridge.timmo.dev/commands/search.md): Arguments and flags for every ha-bridge search command.

### Migrations

- [Migrating from Go Automate](https://ha-bridge.timmo.dev/from-go-automate.md): What changes when you move from Go Automate to ha-bridge.