Unofficial CLI compatible with the API used by Hive (by British Gas) smart devices.
hivecli is written in Go using the go-hive library and also serves as a comprehensive example for using it.
This software is in no way endorsed by British Gas. The underlying REST API
is undocumented and subject to change at any time, which means
suddenly stop working.
Use at your own risk.
In addition, the CLI only supports a subset of the API - specifically, the devices I personally own. Most notably, smart heating is not supported.
Contributions are welcome.
You can find the latest version of the binary in the releases section.
$ hivecli [OPTION]... COMMAND [ARGUMENT]...
hivecli with no arguments will display the supported commands and how
The first time
hivecli is used to run a command, it will ask for the following
- Your username
- Your password
- The login URL API endpoint (for Hive, the default login URL
The password will then be stored in your platform's keyring (dbus
/usr/bin/security under MacOS and Credential Manager under
Windows), while the username and login URL are stored in the config file.