HydroNode CLI
hydronode brings your sensors to the terminal: status, values, live view, switching, commands, the console and exports. Made for makers and for scripts.
Pick your system
| System | Command |
|---|---|
| macOS, Linux (Homebrew) | brew install texhfexlabs/tap/hydronode |
| macOS, Linux | curl -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
| Command | When |
|---|---|
hydronode login | Asks which way you want |
hydronode login --web | Opens the browser on this computer |
hydronode login --device | Over SSH or on a Raspberry Pi: shows a code you enter on hydronode.tech/device |
hydronode login --with-token | An API token from stdin, for scripts. A read token can only read |
hydronode whoami | Who 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
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
| Command | What it does |
|---|---|
status | What needs attention, device counts, unread messages |
sensors | List, show, create, rename, delete, credentials |
values | Summary of a span, periods below or above a line, compare, raw values with --raw |
watch | Live view in the terminal, --plain for one line per reading |
set, command | Switch a data point, send a typed command |
console | The device console, -f to follow |
devices | Firmware and settings over the air, with a check first |
anomalies, messages, stations, automations | Read and act on them |
export | CSV, JSON or Parquet |
simulate | Sends realistic readings as a device, best on a test sensor |
api | Any 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
hydronode profile add work --server https://hydronode.tech hydronode -p work login hydronode values <sensor-id>/temperature --from 24h --json | jq .avg
| Exit code | Meaning |
|---|---|
0 | Done |
1 | Something went wrong |
2 | The command was not written right |
3 | Not signed in, or not allowed |
4 | Not 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.