CLI tool for Grip Connect devices
npm install @hangtime/grip-connect-cliA Command Line Interface for connecting to grip strength training devices via Bluetooth, powered by@hangtime/grip-connect and webbluetooth.
``sh`
npx @hangtime/grip-connect-cli
This launches interactive mode where you can pick a device, connect, and choose actions.
If you see “could not determine executable to run”, your environment may be using an older cached or local version—use
@latest (or a specific version) explicitly as above.
`shInteractive mode (pick device and actions)
npx @hangtime/grip-connect-cli@latest
Optional: Global install
sh
npm install -g @hangtime/grip-connect-cli
`Then use the
command anywhere:`sh
Interactive mode (pick device and actions)
grip-connectList all supported devices
grip-connect listStream force data for 10 seconds
grip-connect stream progressorStream indefinitely until Ctrl+C
grip-connect watch progressorShow device info (battery, firmware, etc.)
grip-connect info entralpiExport session data
grip-connect download forceboard --format csvRun tare (zero) calibration
grip-connect tare motherboard --duration 5000Monitor activity status
grip-connect active progressor --threshold 2.5
`Supported Devices
| Key | Name | Capabilities |
| -------------- | -------------- | --------------------------------------- |
| climbro | Climbro | battery, tare, download, active |
| entralpi | Entralpi | battery, tare, download, active |
| forceboard | ForceBoard | stream, battery, tare, download, active |
| motherboard | Motherboard | stream, battery, tare, download, active |
| mysmartboard | mySmartBoard | tare, download, active |
| pb-700bt | PB-700BT | battery, tare, download, active |
| progressor | Progressor | stream, battery, tare, download, active |
| smartboard-pro | SmartBoard Pro | tare, download, active |
| wh-c06 | WH-C06 | tare, download, active |
Options
sh
grip-connect --json # Output newline-delimited JSON
grip-connect --no-color # Disable colored output
grip-connect --version # Show version
grip-connect --help # Show help
`JSON Mode
Use
for machine-readable output, useful for piping into other tools:`sh
grip-connect --json list
grip-connect --json stream progressor
grip-connect --json watch forceboard | jq '.current'
``- Node.js 22+
- A Bluetooth adapter