👋 Introduction

duux-cli is a terminal client for the Duux Whisper Flex 2 smart fan. Run duux with no arguments for a full-screen Ink control panel, or reach for one of its subcommands to sign in, discover fans, or script a change from a shell.

What's here

• 🚀 Getting started — sign in, discover a fan, and what happens on first run
• 🎛️ The TUI — every row, every keybinding, and what (unconfirmed) means
• ⌨️ Commands — full reference for auth, discover, devices, switch, status, prefs, and debug
• 🎨 Preferences — icon style and where config lives on disk
• 🔧 Troubleshooting & API notes — which fan parameters are confirmed versus provisional, and how to probe the rest