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

Results appear quickly — an initial batch of nearby peripherals is delivered after about 1 s, and a more complete set arrives once the full ~8 s scan window finishes. Discovered peripherals are deduplicated by address and sorted: connected devices first, then paired devices, then named devices (alphabetically by name), then anonymous peripherals (by descending RSSI — strongest signal first). Ties within each group fall back to address ascending.

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. The scan runs in two passes over roughly 8 s total (an early ~1 s partial pass, then a full pass); list waits for the stream to finish before printing, so expect it to take up to ~8 s to return.

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