⌨️ Commands

Running duux with no arguments opens the TUI. Every subcommand below runs headless instead, for scripting or quick checks.

duux auth

Alias: duux login

Signs in to Duux via the passwordless email code flow — see Getting started for the interactive steps. If you're already signed in, it confirms before starting a new session.

duux discover

Fetches the fans registered on your Duux account and saves them locally.

duux discover [--select]

• -s, --select — force the fan picker even if a fan is already active. Without it, discovery only prompts when no fan is currently selected.

duux devices

Lists every fan discovery has found, marking the active one:

● Living Room (current)
○ Bedroom

Takes no arguments.

duux switch

Changes which fan is active.

duux switch [device]

• With a name or id argument, switches directly to the matching fan (matched against known devices; prints an error and the device list if nothing matches).
• With no argument, opens an interactive picker — unless only one fan is known, in which case it just reports that fan is the only option.

duux status

Prints the active fan's current state: connection, power, speed, mode, both oscillation axes, and the timer. Exits non-zero and prints the config file location if no fan is selected or the fan can't be reached.

Takes no arguments.

duux prefs

Opens the same preferences panel as pressing o inside the TUI, as a standalone screen. See Preferences for what it controls. Unlike every other command, it doesn't require you to be signed in or have a fan selected — every change here is a local config write.

duux debug

Sends a raw command string to the active fan and prints the resulting state.

duux debug "<command>"

Example:

duux debug "tune set horosc 3"

This bypasses the CLI's typed builders entirely, so it can send values the normal controls would reject — which is the point. See Troubleshooting & API notes for why this command exists and what it's used to probe.