dyson-cli

# Dyson CLI ## Prerequisites 1. CLI installed at `~/dyson-cli` with venv 2. **Must be on same WiFi as the Dyson** - local MQTT only, won't work remotely **Quick check:** ```bash cd ~/dyson-cli && source .venv/bin/activate && dyson list --check ``` ## Commands ### Power ```bash dyson on # Turn on dyson off # Turn off ``` ### Fan Control ```bash dyson fan speed 5 # Speed 1-10 dyson fan speed auto # Auto mode dyson fan oscillate on # Enable oscillation dyson fan oscillate on -a 90 # 90° sweep (45/90/180/350) dyson fan oscillate off # Disable oscillation ``` ### Heat Control (Hot+Cool models) ```bash dyson heat on # Enable heating dyson heat off # Disable heating dyson heat target 22 # Set target temp (°C) ``` ### Other ```bash dyson night on # Night mode on dyson night off # Night mode off dyson status # Show current state dyson status --json # JSON output ``` ### Multiple Devices Use `-d <name>` to target a specific device: ```bash dyson on -d "Bedroom" dyson fan speed auto -d "Office" ``` ## Common Patterns ```bash # "Turn on the Dyson and set to auto" dyson on && dyson fan speed auto # "Heat to 23 degrees" dyson heat on && dyson heat target 23 # "Turn on with gentle oscillation" dyson on && dyson fan speed 3 && dyson fan oscillate on -a 45 # "What's the current temperature?" dyson status --json | python3 -c "import sys,json; d=json.load(sys.stdin); print(f\"Temp: {d['temperature']-273:.1f}°C, Humidity: {d['humidity']}%\")" ``` ## Troubleshooting If commands fail: 1. Check device is online: `dyson list --check` 2. Ensure on same WiFi network as the Dyson 3. Re-run setup if credentials expired: `dyson setup` For installation, device setup, and full documentation, see [README.md](README.md).