~/headspin $ ls docs_

HeadSpin Control.

A Claude Code plugin for driving real devices on a HeadSpin farm — and finding real accessibility & UI defects in the app under test. HAR-verified auth, device inventory, full capture sessions (lock → record → drive → report), an Appium-driven a11y defect analyzer, Waterfall issue-card reports, and MP4/HAR download. Live-validated on real devices, no mocks.

v1.2.0 MIT 20/20 MCP tools live · app-defect detection · 34 devices
// new — capabilities

Capabilities Deck

20-slide walkthrough of the whole plugin: devices, control, capture, explore/a11y-defects, waterfall, report — real commands, real output, the full 20-tool + 10-command inventory.

▸ open bug-finding-deck.html
// new — data flow

Bug-Finding Data Flow

Interactive diagram: token → automation-config → Appium session → live device → page_source → a11y analyzer → bug report. The chain that finds real app defects.

▸ open bug-finding-dataflow.html
// visual reference

Architecture & Docs

Interactive one-page reference: architecture diagram, the 5-carrier auth model, MCP tool inventory, and validation results.

▸ open docs.html
// presentation

Slide Deck

17-slide walkthrough — the planes, the auth model, the lock-detection fix, the two-JWT gotcha, and how to get started.

▸ open deck.html
// setup

Install Guide

Full install, a real smoke test that lists your live device roster, and troubleshooting.

▸ read INSTALL.md
// onboarding

Getting Started

Day-by-day: log in, inspect a device, reserve / drive / release, and the two-credential model explained.

▸ read GETTING-STARTED.md
// cookbook — new in 1.2

Usage Cookbook

Real request/response examples for all 20 MCP tools: capture lifecycle, session reports, time series, MP4/HAR downloads — every response captured live.

▸ read USAGE.md