Getting Started

ReadyCheck is a Claude Code plugin for macOS that makes debugging faster by capturing everything that happens while your app runs — screen recording, voice narration, and function-level traces — into a single synchronized session bundle. When something goes wrong, you have evidence, not guesses.

Quick Start

Install ReadyCheck as a Claude Code plugin:

claude plugin marketplace add readycheck-dev/skills
claude plugin install readycheck@readycheck

Then run your app with full capture and automatic analysis:

/check Run my app

ReadyCheck builds your app, launches it with tracing enabled, captures all three tracks simultaneously, and analyzes the session when you’re done.

What Gets Captured

Every session records three synchronized tracks:

Track	What it captures	Why it matters
Screen	Frame-by-frame recording	See exactly what the user saw
Voice	Audio narration + transcript	Understand what the user intended
Traces	Function calls with sub-μs precision	Know what the code actually did

Documentation

Skills

Skill	Description
/check — Build, Run, Capture, Analyze	Build and launch your app with full tracing, then automatically analyze the session.
/analyze — Evidence-Based Diagnosis	Analyze a captured session using voice-first correlation across all three tracks.
/doctor — System Health Check	Verify all ReadyCheck dependencies and system requirements.

Commands

Command	Description
ada capture	Start a capture session, launching your app with full tracing enabled.
ada query	Query captured session data — traces, transcripts, screenshots, and metadata.
ada session	List and resolve captured session bundles.
ada doctor	Verify ReadyCheck dependencies from the CLI.
ada trace	Low-level trace management for advanced workflows.
ada symbols	Symbol resolution and dSYM management.
ada analysis	Manage analysis sessions.

Concepts

Page	Description
Sessions	Understanding ReadyCheck session bundles.
The Three Tracks	Understanding ReadyCheck’s three synchronized capture tracks.

Developers

The Developers section covers the CLI reference, data formats, building from source, and contributing to ReadyCheck.