Pick your system

SystemCommand
macOS, Linux (Homebrew)brew install texhfexlabs/tap/hydronode
macOS, Linuxcurl -LsSf https://github.com/TexhFexLabs/hydronode-cli/releases/latest/download/hydronode-cli-installer.sh | sh
Windows (PowerShell)irm https://github.com/TexhFexLabs/hydronode-cli/releases/latest/download/hydronode-cli-installer.ps1 | iex
Linux (Snap)sudo snap install hydronode

Homebrew and the install scripts also add hn, a short name for the same program. With Snap, sudo snap alias hydronode.hn hn adds it. Every download is on GitHub Releases with a checksum and a build attestation.

Browser, device code or token

CommandWhen
hydronode loginAsks which way you want
hydronode login --webOpens the browser on this computer
hydronode login --deviceOver SSH or on a Raspberry Pi: shows a code you enter on hydronode.tech/device
hydronode login --with-tokenAn API token from stdin, for scripts. A read token can only read
hydronode whoamiWho you are signed in as, and what you may do

The browser and the device code end on the same page: HydroNode asks you to allow Full access to your account, after a sign-in from the last five minutes. The CLI then shows up under Sessions & security as HydroNode CLI, where you can sign it out. Keys stay in the keychain of your system.

The commands you need most

Shell
hydronode status
hydronode sensors list
hydronode values <sensor-id>/temperature --from 7d
hydronode values compare <point-id> <point-id> --from 24h
hydronode watch "Greenhouse climate"
hydronode set <sensor-id>/pump off
hydronode console <sensor-id> -f --rejected
CommandWhat it does
statusWhat needs attention, device counts, unread messages
sensorsList, show, create, rename, delete, credentials
valuesSummary of a span, periods below or above a line, compare, raw values with --raw
watchLive view in the terminal, --plain for one line per reading
set, commandSwitch a data point, send a typed command
consoleThe device console, -f to follow
devicesFirmware and settings over the air, with a check first
anomalies, messages, stations, automationsRead and act on them
exportCSV, JSON or Parquet
simulateSends realistic readings as a device, best on a test sensor
apiAny API call with your sign-in, for what has no command yet

hydronode help <command> explains each one with examples.

Profiles, JSON and exit codes

Shell
hydronode profile add work --server https://hydronode.tech
hydronode -p work login
hydronode values <sensor-id>/temperature --from 24h --json | jq .avg
Exit codeMeaning
0Done
1Something went wrong
2The command was not written right
3Not signed in, or not allowed
4Not found

--json prints a fixed format that does not change with the terminal width. NO_COLOR turns colours off. Want an AI app instead of a terminal? See AI apps with MCP.