Shelly CLI
Docs

Docs

Welcome to the Shelly CLI documentation! Here you’ll find everything you need to get started with controlling your Shelly smart home devices from the command line.

Getting Started

Install the CLI and control your first device

Command Reference

Browse all 350+ commands

Configuration

Configure devices, groups, and scenes

What is Shelly CLI?

Shelly CLI is a powerful command-line interface for managing Shelly smart home devices. It provides:

  • Unified control for all Shelly device generations (Gen1, Gen2, Gen3, Gen4)
  • Batch operations for controlling multiple devices simultaneously
  • TUI dashboard for visual device management
  • Scriptable output in JSON, YAML, CSV, and Go template formats
  • Plugin system for extending functionality
  • 280+ themes for customizing the terminal appearance

Getting Help

  • Run shelly --help for a list of available commands
  • Run shelly <command> --help for help on a specific command
  • Visit our GitHub repository for issues and discussions