# Ble Session Appliance

> Control BLE Session Appliance through the generated BLE device CLI.

- Skill: `mvanhorn-cli-printing-press/ble-session-appliance` (Agent Skill, multi-file: 17 files)
- Install (CLI): `npx skillmds add mvanhorn-cli-printing-press/ble-session-appliance`
- Raw SKILL.md: https://api.skillmd.com/api/skills/mvanhorn-cli-printing-press/ble-session-appliance/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- Author: mvanhorn (https://skillmd.com/u/mvanhorn-cli-printing-press)
- Updated: 2026-09-09
- Page: https://skillmd.com/skills/mvanhorn-cli-printing-press/ble-session-appliance

---


## 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:
   ```bash
   npx -y @mvanhorn/printing-press-library install ble-session-appliance --cli-only
   ```
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 ble_live` 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.