Agent skill · software engineering · mvanhorn
ble-session-appliance
Control BLE Session Appliance through the generated BLE device CLI.
Why this skill is useful
Provides specific commands and workflows for controlling BLE devices that the AI wouldn't reliably generate on its own.
What it needs
Requires ble-session-appliance-pp-cli installed locally. About 1k tokens when loaded. Last updated 2026-08-06. 4,383 stars on the source repository.
What this skill does
Prerequisites: Install the CLI This skill drives the ble-session-appliance-pp-cli binary. You must verify the CLI is installed before invoking any command from this skill. If it is missing, install it first: 1. Install via the Printing Press installer. It defaults binaries to $HOME/.local/bin on macOS/Linux and %LOCALAPPDATA%\Programs\PrintingPress\bin on Windows: 2. Verify: ble-session-appliance-pp-cli --version 3. Ensure the reported install directory is on $PATH for the agent/runtime that will invoke this skill. If the npx install fails before this CLI has a public-library category, install Node or use the category-specific Go fallback after publish. If --version reports "command not found" after install, the runtime cannot see the binary directory on $PATH. Do not proceed with skill commands until verification succeeds. Use ble-session-appliance-pp-cli capabilities --json to inspect callable and withheld BLE capabilities, including safety classes and evidence refs. Use ble-session-appliance-pp-cli status --json to inspect replay-backed status output. By default the CLI is replay-backed; build with -tags blelive and pass --live to control a real device, ble-session-appliance-pp-cli doctor to check live readiness, and ble-session-appliance-pp-cli scan --live to discover devices. Use ble-session-appliance-pp-cli start --dry-run --json to preview the start write. To run it outside verify mode, pass --confirm-physical-effect after checking the dry-run output. Use ble-session-appliance-pp-cli session start --json and ble-session-appliance-pp-cli session status --json to inspect the local replay session runtime, including lock, capability-token, and endpoint metadata. Use ble-session-appliance-pp-cli telemetry capture --json and ble-session-appliance-pp-cli telemetry latest --json for the local telemetry store scaffold. Use ble-session-appliance-pp-cli telemetry sessions --json to inspect stored BLE session summaries.
How to use it
Reference it in AdaL, Claude Code, Cursor or any coding agent — nothing to install:
@skills mvanhorn/ble-session-appliance