Skip to content
Home Assistant Bridge
Esc
↑↓navigate↵open⌘Jpreview
On this page

Commands

Every Home Assistant Bridge command, alias, argument and flag, generated from the CLI's help.

Every command and its help, as ha-bridge <command> --help prints it. Each command also accepts the global flags listed under ha-bridge.

ha-bridge

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

USAGE
  ha-bridge <subcommand> [flags]

FLAGS
  --socket string    Path to the bridge socket (default: $HA_BRIDGE_SOCK, then $XDG_RUNTIME_DIR/ha-bridge/ha-bridge.sock)

GLOBAL FLAGS
  --help, -h                                                          Show help information
  --version, -v                                                       Show version information
  --wizard                                                            Start wizard mode for a command
  --completions <bash|zsh|fish|sh>                                    Print shell completion script (choices: bash, zsh, fish, sh)
  --log-level <all|trace|debug|info|warn|warning|error|fatal|none>    Sets the minimum log level (choices: all, trace, debug, info, warn, warning, error, fatal, none)

SUBCOMMANDS
  serve               Hold the shared Home Assistant connection and serve it on the bridge socket
  setup               Set the Home Assistant URL and access token
  watch, w            Watch entities through the bridge
  assist_satellite, as Assist satellite actions
  input_boolean, ib   Input boolean actions
  input_number, in    Input number actions
  light, l            Light actions
  switch, s           Switch actions
  cover, c            Cover actions
  climate, cl         Climate actions
  camera              Camera actions

ha-bridge serve

DESCRIPTION
  Hold the shared Home Assistant connection and serve it on the bridge socket

USAGE
  ha-bridge serve [flags]

FLAGS
  --socket string    Path to the bridge socket (default: $HA_BRIDGE_SOCK, then $XDG_RUNTIME_DIR/ha-bridge/ha-bridge.sock)

ha-bridge setup

DESCRIPTION
  Set the Home Assistant URL and access token

USAGE
  ha-bridge setup [flags]

FLAGS
  --socket string    Path to the bridge socket (default: $HA_BRIDGE_SOCK, then $XDG_RUNTIME_DIR/ha-bridge/ha-bridge.sock)

ha-bridge watch

Alias: ha-bridge w

DESCRIPTION
  Watch entities through the bridge

USAGE
  ha-bridge watch <subcommand> [flags]

FLAGS
  --socket string    Path to the bridge socket (default: $HA_BRIDGE_SOCK, then $XDG_RUNTIME_DIR/ha-bridge/ha-bridge.sock)

ha-bridge watch entity

Alias: ha-bridge watch e

DESCRIPTION
  Print an entity's state now and on every change

USAGE
  ha-bridge watch entity [flags] <entity_id>

ARGUMENTS
  entity_id string    Entity to watch, for example light.office

FLAGS
  --socket string         Path to the bridge socket (default: $HA_BRIDGE_SOCK, then $XDG_RUNTIME_DIR/ha-bridge/ha-bridge.sock)
  --bar-json              Print one bar JSON object per state
  --icon string           Text to show instead of the state
  --text-on string        Text appended when the entity is on
  --text-off string       Text appended when the entity is off
  --tooltip-on string     Tooltip when the entity is on
  --tooltip-off string    Tooltip when the entity is off
  --class-on string       Class when the entity is on
  --class-off string      Class when the entity is off

ha-bridge assist_satellite

Alias: ha-bridge as

DESCRIPTION
  Assist satellite actions

USAGE
  ha-bridge assist_satellite <subcommand> [flags]

FLAGS
  --socket string    Path to the bridge socket (default: $HA_BRIDGE_SOCK, then $XDG_RUNTIME_DIR/ha-bridge/ha-bridge.sock)

ha-bridge assist_satellite announce

Alias: ha-bridge assist_satellite a

DESCRIPTION
  Announce a message on an area's satellites

USAGE
  ha-bridge assist_satellite announce [flags] <area_id> <message>

ARGUMENTS
  area_id string    Area to announce in
  message string    Message to announce

FLAGS
  --socket string    Path to the bridge socket (default: $HA_BRIDGE_SOCK, then $XDG_RUNTIME_DIR/ha-bridge/ha-bridge.sock)

ha-bridge input_boolean

Alias: ha-bridge ib

DESCRIPTION
  Input boolean actions

USAGE
  ha-bridge input_boolean <subcommand> [flags]

FLAGS
  --socket string    Path to the bridge socket (default: $HA_BRIDGE_SOCK, then $XDG_RUNTIME_DIR/ha-bridge/ha-bridge.sock)

ha-bridge input_boolean turn-on

Alias: ha-bridge input_boolean on

DESCRIPTION
  Turn on

USAGE
  ha-bridge input_boolean turn-on [flags] <name>

ARGUMENTS
  name string    Entity name without the input_boolean. prefix

FLAGS
  --socket string    Path to the bridge socket (default: $HA_BRIDGE_SOCK, then $XDG_RUNTIME_DIR/ha-bridge/ha-bridge.sock)

ha-bridge input_boolean turn-off

Alias: ha-bridge input_boolean off

DESCRIPTION
  Turn off

USAGE
  ha-bridge input_boolean turn-off [flags] <name>

ARGUMENTS
  name string    Entity name without the input_boolean. prefix

FLAGS
  --socket string    Path to the bridge socket (default: $HA_BRIDGE_SOCK, then $XDG_RUNTIME_DIR/ha-bridge/ha-bridge.sock)

ha-bridge input_boolean toggle

Alias: ha-bridge input_boolean t

DESCRIPTION
  Toggle

USAGE
  ha-bridge input_boolean toggle [flags] <name>

ARGUMENTS
  name string    Entity name without the input_boolean. prefix

FLAGS
  --socket string    Path to the bridge socket (default: $HA_BRIDGE_SOCK, then $XDG_RUNTIME_DIR/ha-bridge/ha-bridge.sock)

ha-bridge input_number

Alias: ha-bridge in

DESCRIPTION
  Input number actions

USAGE
  ha-bridge input_number <subcommand> [flags]

FLAGS
  --socket string    Path to the bridge socket (default: $HA_BRIDGE_SOCK, then $XDG_RUNTIME_DIR/ha-bridge/ha-bridge.sock)

ha-bridge input_number increment

DESCRIPTION
  Raise the value by one step

USAGE
  ha-bridge input_number increment [flags] <name>

ARGUMENTS
  name string    Entity name without the input_number. prefix

FLAGS
  --socket string    Path to the bridge socket (default: $HA_BRIDGE_SOCK, then $XDG_RUNTIME_DIR/ha-bridge/ha-bridge.sock)

ha-bridge input_number decrement

DESCRIPTION
  Lower the value by one step

USAGE
  ha-bridge input_number decrement [flags] <name>

ARGUMENTS
  name string    Entity name without the input_number. prefix

FLAGS
  --socket string    Path to the bridge socket (default: $HA_BRIDGE_SOCK, then $XDG_RUNTIME_DIR/ha-bridge/ha-bridge.sock)

ha-bridge input_number set-value

DESCRIPTION
  Set the value

USAGE
  ha-bridge input_number set-value [flags] <name> <value>

ARGUMENTS
  name string     Entity name without the input_number. prefix
  value string    New value

FLAGS
  --socket string    Path to the bridge socket (default: $HA_BRIDGE_SOCK, then $XDG_RUNTIME_DIR/ha-bridge/ha-bridge.sock)

ha-bridge light

Alias: ha-bridge l

DESCRIPTION
  Light actions

USAGE
  ha-bridge light <subcommand> [flags]

FLAGS
  --socket string    Path to the bridge socket (default: $HA_BRIDGE_SOCK, then $XDG_RUNTIME_DIR/ha-bridge/ha-bridge.sock)

ha-bridge light turn-on

Alias: ha-bridge light on

DESCRIPTION
  Turn on

USAGE
  ha-bridge light turn-on [flags] <name>

ARGUMENTS
  name string    Entity name without the light. prefix

FLAGS
  --socket string    Path to the bridge socket (default: $HA_BRIDGE_SOCK, then $XDG_RUNTIME_DIR/ha-bridge/ha-bridge.sock)

ha-bridge light turn-off

Alias: ha-bridge light off

DESCRIPTION
  Turn off

USAGE
  ha-bridge light turn-off [flags] <name>

ARGUMENTS
  name string    Entity name without the light. prefix

FLAGS
  --socket string    Path to the bridge socket (default: $HA_BRIDGE_SOCK, then $XDG_RUNTIME_DIR/ha-bridge/ha-bridge.sock)

ha-bridge light toggle

Alias: ha-bridge light t

DESCRIPTION
  Toggle

USAGE
  ha-bridge light toggle [flags] <name>

ARGUMENTS
  name string    Entity name without the light. prefix

FLAGS
  --socket string    Path to the bridge socket (default: $HA_BRIDGE_SOCK, then $XDG_RUNTIME_DIR/ha-bridge/ha-bridge.sock)

ha-bridge switch

Alias: ha-bridge s

DESCRIPTION
  Switch actions

USAGE
  ha-bridge switch <subcommand> [flags]

FLAGS
  --socket string    Path to the bridge socket (default: $HA_BRIDGE_SOCK, then $XDG_RUNTIME_DIR/ha-bridge/ha-bridge.sock)

ha-bridge switch turn-on

Alias: ha-bridge switch on

DESCRIPTION
  Turn on

USAGE
  ha-bridge switch turn-on [flags] <name>

ARGUMENTS
  name string    Entity name without the switch. prefix

FLAGS
  --socket string    Path to the bridge socket (default: $HA_BRIDGE_SOCK, then $XDG_RUNTIME_DIR/ha-bridge/ha-bridge.sock)

ha-bridge switch turn-off

Alias: ha-bridge switch off

DESCRIPTION
  Turn off

USAGE
  ha-bridge switch turn-off [flags] <name>

ARGUMENTS
  name string    Entity name without the switch. prefix

FLAGS
  --socket string    Path to the bridge socket (default: $HA_BRIDGE_SOCK, then $XDG_RUNTIME_DIR/ha-bridge/ha-bridge.sock)

ha-bridge switch toggle

Alias: ha-bridge switch t

DESCRIPTION
  Toggle

USAGE
  ha-bridge switch toggle [flags] <name>

ARGUMENTS
  name string    Entity name without the switch. prefix

FLAGS
  --socket string    Path to the bridge socket (default: $HA_BRIDGE_SOCK, then $XDG_RUNTIME_DIR/ha-bridge/ha-bridge.sock)

ha-bridge cover

Alias: ha-bridge c

DESCRIPTION
  Cover actions

USAGE
  ha-bridge cover <subcommand> [flags]

FLAGS
  --socket string    Path to the bridge socket (default: $HA_BRIDGE_SOCK, then $XDG_RUNTIME_DIR/ha-bridge/ha-bridge.sock)

ha-bridge cover watch

Alias: ha-bridge cover w

DESCRIPTION
  Print bar JSON now and on every change

USAGE
  ha-bridge cover watch [flags] <name>

ARGUMENTS
  name string    Entity name without the cover. prefix

FLAGS
  --socket string    Path to the bridge socket (default: $HA_BRIDGE_SOCK, then $XDG_RUNTIME_DIR/ha-bridge/ha-bridge.sock)

ha-bridge cover position

DESCRIPTION
  Set the position

USAGE
  ha-bridge cover position [flags] <name> <position>

ARGUMENTS
  name string        Entity name without the cover. prefix
  position string    Position from 0 to 100

FLAGS
  --socket string    Path to the bridge socket (default: $HA_BRIDGE_SOCK, then $XDG_RUNTIME_DIR/ha-bridge/ha-bridge.sock)

ha-bridge cover tilt-position

DESCRIPTION
  Set the tilt position

USAGE
  ha-bridge cover tilt-position [flags] <name> <position>

ARGUMENTS
  name string        Entity name without the cover. prefix
  position string    Position from 0 to 100

FLAGS
  --socket string    Path to the bridge socket (default: $HA_BRIDGE_SOCK, then $XDG_RUNTIME_DIR/ha-bridge/ha-bridge.sock)

ha-bridge cover close

DESCRIPTION
  Close the cover

USAGE
  ha-bridge cover close [flags] <name>

ARGUMENTS
  name string    Entity name without the cover. prefix

FLAGS
  --socket string    Path to the bridge socket (default: $HA_BRIDGE_SOCK, then $XDG_RUNTIME_DIR/ha-bridge/ha-bridge.sock)

ha-bridge climate

Alias: ha-bridge cl

DESCRIPTION
  Climate actions

USAGE
  ha-bridge climate <subcommand> [flags]

FLAGS
  --socket string    Path to the bridge socket (default: $HA_BRIDGE_SOCK, then $XDG_RUNTIME_DIR/ha-bridge/ha-bridge.sock)

ha-bridge climate watch

Alias: ha-bridge climate w

DESCRIPTION
  Print bar JSON now and on every change

USAGE
  ha-bridge climate watch [flags] <name>

ARGUMENTS
  name string    Entity name without the climate. prefix

FLAGS
  --socket string    Path to the bridge socket (default: $HA_BRIDGE_SOCK, then $XDG_RUNTIME_DIR/ha-bridge/ha-bridge.sock)

ha-bridge climate fan-mode

DESCRIPTION
  Set the fan mode

USAGE
  ha-bridge climate fan-mode [flags] <name> <mode>

ARGUMENTS
  name string    Entity name without the climate. prefix
  mode string    Fan mode, for example 1 or auto

FLAGS
  --socket string    Path to the bridge socket (default: $HA_BRIDGE_SOCK, then $XDG_RUNTIME_DIR/ha-bridge/ha-bridge.sock)

ha-bridge camera

DESCRIPTION
  Camera actions

USAGE
  ha-bridge camera <subcommand> [flags]

FLAGS
  --socket string    Path to the bridge socket (default: $HA_BRIDGE_SOCK, then $XDG_RUNTIME_DIR/ha-bridge/ha-bridge.sock)

ha-bridge camera snapshot

DESCRIPTION
  Save the camera's current image

USAGE
  ha-bridge camera snapshot [flags] <name> <output>

ARGUMENTS
  name string      Entity name without the camera. prefix
  output string    File to write the image to

FLAGS
  --socket string    Path to the bridge socket (default: $HA_BRIDGE_SOCK, then $XDG_RUNTIME_DIR/ha-bridge/ha-bridge.sock)

Last updated on October 1, 2026