headspin-control

Plugin headspin-control from marketplace headspin-dev in krzemienski/headspin-control. Commands read from the repo's manifest — 1 month ago.

Skills (14)

• headspin-bug-report

  Turn a HeadSpin exploration evidence run into standardized, file-a-device-bug reports. Use for "file a device bug report", "headspin bug", "write up a bug from exploration evidence", "make a bug report", "turn crashes into tickets", or after headspin-explore-bugs finds anomalies. Reads an exploratio

• headspin-capture

  Run a full HeadSpin capture session end-to-end on an Android/Cast/FireTV device — lock, start video capture, drive the app via ADB-over-REST (launch, tap, swipe), stop, and poll to capture-complete. LIVE-VALIDATED 2026-07-03 (two parallel YouTube sessions on real Samsung devices, MP4 + report retrie

• headspin-connect-android

  Establish a HeadSpin control session on an Android / Cast / Fire TV device via the Engine.IO-v3 + Socket.IO control channel (the observed Android control plane): open the socket.io control websocket for the device's fleet port, authenticate with the JWT as an ?access_token= query param (NOT a Bearer

• headspin-connect-ios

  Establish a HeadSpin control session on an iOS device. Two real (HAR-observed) surfaces exist in this environment: (1) an Appium wd/hub W3C session created via REST with the 32-hex API token embedded in the URL path (xcuitest driver, headspin:controlLock + headspin:remoteControl caps); (2) the inter

• headspin-connect-roku

  Documented capability — the Roku CONTROL WIRE is DOC-SOURCED, not captured (no Roku traffic in the HAR/Raw captures), though real Roku devices DO exist in this environment (live /v0/devices on 2026-07-02 returned 3 online Roku: YH001N51126312 Roku Streaming Stick+, X02600RUALWE + X02600LX08J3 Roku E

• headspin-connection-manager

  Open and maintain the platform-correct control transport to a HeadSpin device and keep it alive. Two distinct control stacks exist by platform — Android/Cast/FireTV over socket.io (Engine.IO v3) on dev-ca-tor-0:{23100,27100,33100,34100}, and iOS over a raw JSON-over-WS control channel on dev-in-blr-

• headspin-control-ios

  Drive an already-connected iOS device over the two real control surfaces. Interactive input rides the raw JSON-over-WebSocket control channel on dev-in-blr-0:5002 (CONTROL_TOUCH_PATHS for tap/swipe, CONTROL_HOME for Home, CONTROL_WEBRTC_START/…_DISCONNECTED to gate the video leg). Scripted automatio

• headspin-control-roku

  Documented capability — NOT HAR-verified in this environment (no Roku device present in the ui-dev capture). Drive an already-connected Roku device per HeadSpin docs: press keys (Home, Up, Down, Left, Right, OK, Back, Play, Pause, Power, Volume), launch a channel by app id, send literal text input,

• headspin-explore-bugs

  Systematically explore an app on a connected HeadSpin device to discover bugs and crashes. Use for "explore app for bugs", "crawl the app on headspin", "find crashes", "automated exploratory QA on a device", "monkey-test this app", or "walk every screen and flag anomalies". Runs a bounded BFS crawl

• headspin-list-devices

  Enumerate the real devices in the current HeadSpin environment via the two real inventory carriers — iOS through REST GET /v0/idevice/{udid}@{host}/info?json, and Android/Chromecast/Fire TV through the socket.io devicelist event on the control ports — surface availability + lock state, and parse the

• headspin-login

  Authenticate the HeadSpin Control plugin to a HeadSpin environment, persist the bearer token in the OS keychain via ${user_config.api_token}, and surface the resolved environment (UI host, API host, per-platform control hosts/ports) for downstream skills. REST calls use Authorization Bearer; the web

• headspin-reports

  Retrieve HeadSpin performance reports, Waterfall issue-card data, and device time series for a capture session. LIVE-VALIDATED 2026-07-02 against real captured sessions on api-dev.headspin.io — all Bearer REST via the bundled MCP server (hs_list_sessions, hs_session_issues, hs_analysis_status, hs_se

• headspin-session-manager

  Acquire (lock) a HeadSpin device for the current user, track the lock + lease expiry, release (unlock) on Stop / SessionEnd / explicit /headspin:disconnect, and surface lock conflicts when another user holds the device. REST auth is Authorization Bearer (no orgkey); the per-device lock/unlock REST r

• headspin-waterfall

  Download and inspect a HeadSpin session's Waterfall network data and captured artifacts — the HAR network waterfall, screen-recording MP4, device event log (device.log.gz), and PCAP. LIVE-VALIDATED 2026-07-02 against real captured sessions (real 3.1 MB MP4, 36 KB device syslog, real timeseries CSVs

Slash commands (10)

• /headspin-control:capture

  Run a full HeadSpin capture session (lock → record → drive app → stop → report-ready) on a real Android/Cast/FireTV device

• /headspin-control:connect

  Lock and open a control session on a HeadSpin device, routing to the iOS / Roku / Android connect skill.

• /headspin-control:control

  Drive an already-connected HeadSpin device — screenshot, keypress, tap, swipe, type, launch app.

• /headspin-control:devices

  List real devices in the current HeadSpin environment, filtered by platform, grouped by availability and lock status.

• /headspin-control:explore

  Run bounded automated exploration on a connected device to surface bugs, capturing evidence bundles.

• /headspin-control:login

  Authenticate to a HeadSpin environment — open the UI to sign in, accept a pasted API token, validate, and persist non-secret env.

• /headspin-control:report

  Produce a standardized bug report from an exploration run directory.

• /headspin-control:sessions

  Retrieve HeadSpin performance reports for a capture session — the Waterfall issue card, analysis status, and device time series (memory, battery, network, video-quality).

• /headspin-control:setup

  Onboard the HeadSpin Control plugin — verify config, explain userConfig, and confirm API connectivity.

• /headspin-control:waterfall

  Download and inspect a HeadSpin session's Waterfall network data and captured artifacts (HAR, screen-recording MP4, device event log, PCAP).

Subagents (2)

• bug-reporter

  Triage the anomalies from a device-explorer run and turn them into standardized bug reports. Use when the user says "file the bugs from that run", "report what the explorer found", "triage the anomalies", "write up the issues", or after device-explorer finishes and a run directory exists. Reads a ru

• device-explorer

  Autonomously explore a locked HeadSpin device to surface UI/functional anomalies. Use when the user says 'explore this device', 'crawl the app for bugs', 'run an exploration pass', 'find issues on the device', or 'auto-QA this build'. Locks a device, opens the control tunnel, runs a bounded BFS craw

MCP servers (1)

• headspin

  runs: python3 ${CLAUDE_PLUGIN_ROOT}/mcp/headspin_mcp_server.py

Hooks (3)

• PreToolUse

  ${CLAUDE_PLUGIN_ROOT}/hooks/scripts/auth-guard.sh

• PostToolUse

  ${CLAUDE_PLUGIN_ROOT}/hooks/scripts/interaction-log.sh

• Stop

  ${CLAUDE_PLUGIN_ROOT}/hooks/scripts/session-release.sh

Similar plugins