solcito
A native macOS command-line tool for managing Logitech wireless receivers — pair, unpair and inspect your Unifying, Bolt, Lightspeed and Nano devices without leaving the terminal.
# me @ lintuxt.ai in ~ $ solcito solcito v0.1.6 · Logitech wireless device manager ● Unifying Receiver [1] No paired devices ● Unifying Receiver [2] ✓ MX Ergo Multi-Device Trackball · slot 2 · 90% (asleep) Commands solcito --pair Pair a new device (you'll be asked which receiver) solcito --unpair <slot> Remove a device (you'll be asked which receiver) # me @ lintuxt.ai in ~ $
Three things, from one binary
List your receivers
See every connected receiver and its paired devices by slot, with battery level and charging status.
Add a device
Put a receiver into pairing mode and add a new mouse or keyboard, all from the command line.
Remove a device
Free up a slot by removing a paired device by its slot number. Reversible, no surprises.
Install in one line
curl -fsSL https://raw.githubusercontent.com/lintuxt/solcito/trunk/install.sh | sh
Downloads the latest release for Apple Silicon, verifies its SHA-256 checksum, and installs to ~/.local/bin (or /usr/local/bin).
Quickstart
solcito # show your receiver and paired devices
solcito --pair # add a new device
solcito --unpair <slot> # remove a device
solcito --help # full help
Why it exists
Managing Logitech wireless devices on macOS — pairing, unpairing, checking battery — has historically required Logi Options+, a multi-hundred-megabyte Electron application with a background daemon, login items, and a settings pane. That's a lot of resident infrastructure for what boils down to two or three operations you do twice a year.
solcito is the inverse: one static Swift binary, zero background processes, zero login items. You run it from your terminal when you actually need to pair a new mouse; the rest of the time it isn't running. It talks to the Logitech receiver directly over Apple's IOKit HID layer using the HID++ protocol — the same protocol Logi Options+ uses, just without the wrapping.
The trade-off is that solcito doesn't do everything Logi Options+ does. There's no per-app key remapping, no Flow cursor handoff between machines, no firmware upgrades, no on-screen battery widget. If you depend on those, keep Logi Options+ installed. solcito covers the "I bought a new mouse and want to pair it without installing 400 MB of Electron" workflow — pair, unpair, inspect what's connected and how much battery it has.
Sponsor
If solcito spared you from installing Logi Options+, consider supporting future work.
Build from source · Requirements · License
Requirements
macOS 13 or later on Apple Silicon. No other dependencies.
Build from source
Requires Xcode 16+ (Swift 6).
git clone https://github.com/lintuxt/solcito.git
cd solcito
swift build -c release
./.build/release/solcito --help
Acknowledgements
The HID++ protocol encoding in Sources/HIDPP/ is transliterated from Solaar's Python implementation, which is why solcito is GPL-2.0 licensed.
License
GPL-2.0 — see LICENSE.