Shelly CLI
Docs

shelly shelly

shelly

CLI for controlling Shelly smart home devices

Synopsis

Shelly CLI - Control your Shelly smart home devices from the command line.

This tool provides a comprehensive interface for discovering, monitoring, and controlling Shelly devices on your local network.

Examples

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15

  # Initialize configuration
  shelly init

  # Discover and control devices
  shelly discover scan
  shelly switch on kitchen

  # Pipe output to jq for processing
  shelly device list -o json | jq '.[].name'

  # Pipe device names to batch commands
  echo -e "kitchen\nbedroom" | shelly batch on

  # Launch interactive dashboard
  shelly dash

Options

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13

      --config string           Config file (default $HOME/.config/shelly/config.yaml)
  -h, --help                    help for shelly
      --log-categories string   Filter logs by category (comma-separated: network,api,device,config,auth,plugin)
      --log-json                Output logs in JSON format
      --no-color                Disable colored output
      --no-headers              Hide table headers in output
      --offline                 Only read from cache, error on cache miss
  -o, --output string           Output format (table, json, yaml, template) (default "table")
      --plain                   Disable borders and colors (machine-readable output)
  -q, --quiet                   Suppress non-essential output
      --refresh                 Bypass cache and fetch fresh data from device
      --template string         Go template string for output (use with -o template)
  -v, --verbose count           Increase verbosity (-v=info, -vv=debug, -vvv=trace)

SEE ALSO

Last updated on January 26, 2026
Edit this page on GitHub
Next
Development Guide