wendy device wifi

Manages WiFi on the host machine running the Wendy CLI (not on a connected WendyOS device).

Subcommands

wendy device wifi scan

Lists WiFi networks visible to the host.

wendy device wifi list

wendy device wifi connect

Interactively selects and connects the host to a WiFi network.

wendy device wifi connect [--ssid <name>]

Pass --ssid to skip the interactive network picker.

Platform behavior

macOS

Uses CoreWLAN (scanForNetworks) to perform a synchronous, on-demand scan. Results are always current.

Keychain lookup is supported: previously saved "AirPort network password" entries are read automatically, so the password prompt is often skipped.

Linux

Uses nmcli device wifi rescan followed by nmcli device wifi list. The rescan is triggered before listing, so results are always current.

Keychain lookup is not supported. The password prompt is always shown when connecting to a network that requires a password.

Windows

Uses netsh wlan show networks mode=bssid to enumerate nearby networks. SSIDs are deduplicated; when a network is visible through multiple BSSIDs (roaming), the strongest signal observed across all BSSIDs is reported. Hidden networks (empty SSID) are skipped.

Important: netsh reads the Windows WLAN service's cached scan list. The service asks the driver to rescan periodically and may not scan at all while the host is already associated to a network. Results may therefore be stale. If the expected network is missing, wait a few seconds and run the command again, or pass --ssid to specify the network directly.

Keychain lookup is not supported. Windows has no equivalent of macOS's auto-stored "AirPort network password" Keychain entry. The password prompt is always shown when connecting to a network that requires a password.

Flags

Wendy Lite devices

Running wendy device wifi in interactive mode against a Wendy Lite device is not supported. The command exits immediately with:

selected device does not support full Wi-Fi management; use 'wendy device wifi connect' and 'wendy device wifi disconnect' instead

Use the explicit subcommands instead:

wendy device wifi connect --ssid <network>
wendy device wifi disconnect

Note: wendy device wifi connect and wendy device wifi disconnect stop the running app on the device before applying the new Wi-Fi configuration. If no app is currently running, this step is skipped silently — no warning is printed.