WendyOS Docs
AdvancedClientsWendy cliCommandsDevice

wendy device bluetooth

Manages Bluetooth peripherals on the connected WendyOS device. Aliased as wendy device bt.

wendy device bluetooth

Manages Bluetooth peripherals on the connected WendyOS device. Aliased as wendy device bt.

Run without a subcommand to open an interactive table for browsing and managing peripherals; the subcommands below remain available for scripting.

Interactive TUI

wendy device bluetooth

Scans the device for nearby Bluetooth peripherals and presents them in an interactive table that stays open between actions. A spinner is shown while the scan window runs (~8s). Discovered peripherals are deduplicated by address and sorted with connected devices first, then paired devices.

KeyAction
/Move the selection
/Scroll the table horizontally (when it overflows)
enterConnect to the selected peripheral (pairs and trusts it)
dDisconnect the selected (connected) peripheral
fForget the selected (paired) peripheral
rRescan
q / escQuit

Actions update the table immediately (optimistically) on success. Because a Bluetooth rescan takes several seconds, the table is not rescanned automatically after each action — press r to refresh against the device.

Subcommands

wendy device bluetooth list

Scans for peripherals and prints them as a table, or as JSON with --json.

wendy device bluetooth list [--json]

wendy device bluetooth connect

Connects to a peripheral by address.

wendy device bluetooth connect <address> [--pair] [--trust]

wendy device bluetooth disconnect

Disconnects a peripheral by address.

wendy device bluetooth disconnect <address>

wendy device bluetooth forget

Removes the pairing for a peripheral by address.

wendy device bluetooth forget <address>

Flags

FlagDescription
--pairPair with the device when connecting (default true, connect only).
--trustTrust the device when connecting (default true, connect only).
--jsonOutput the scan result as JSON (list only).

On this page