duux-cli

Features

• Interactive TUI — arrow-key control panel for power, speed, mode, horizontal/vertical oscillation, night mode, and timer, with live status
• Passwordless sign-in — one-time email code; tokens are stored in the macOS Keychain, never on disk
• Multi-fan aware — discover fans from the Duux cloud, list them, and switch the active one
• Scriptable status — duux status prints a one-shot state readout and sets a non-zero exit code when the fan is unreachable
• Raw command passthrough — duux debug "tune set horosc 3" sends an arbitrary command and prints the fan's response, for probing undocumented parameters
• Local control — Duux's cloud blocks fan control on most accounts; duux broker setup runs a broker on your own network so the fan talks to you directly
• Accessible by default — every state is a glyph plus a word (● on / ○ off); colour only ever reinforces, it never carries meaning alone

Built on @kud/duux, which owns auth, discovery, and the cloud/MQTT transports — this CLI is the terminal surface over it.

Install

npm install -g @kud/duux-cli

Usage

$ duux
# launches the interactive TUI — prompts to sign in / discover on first run

$ duux auth
# passwordless email-code sign-in (alias: login)

$ duux discover --select
# fetch fans from the Duux cloud, save them, and pick the active one

$ duux devices
# list known fans

$ duux switch
# switch the active fan

$ duux status
● on · speed 3 · mode normal · night off

$ duux prefs
# edit preferences (icon style: text or Nerd Font)

$ duux debug "tune set horosc 3"
# send a raw command and print the resulting state

TUI keys: ↑↓ select · ←→ adjust · ⇧←→ adjust by a larger step · ↵/space toggle or cycle · o preferences · q quit

Development

git clone https://github.com/kud/duux-cli.git
cd duux-cli
npm install
npm run dev