Installation
ReadyCheck installs as a Claude Code plugin. Here’s everything you need to know.
Prerequisites
- Claude Code — ReadyCheck runs as a Claude Code plugin
- macOS — Apple Silicon (arm64)
Install the Plugin
claude plugin marketplace add readycheck-dev/skills
claude plugin install readycheck@readycheckThis installs ReadyCheck and makes three skills available: /check, /analyze, and /doctor.
Verify Installation
Run the doctor to confirm everything is set up correctly:
/doctorThe doctor checks for the following components:
| Component | Required For | Notes |
|---|---|---|
| Frida agent library | Function tracing | Bundled with the plugin |
| whisper-cli | Voice transcription | Bundled with the plugin |
| FFmpeg | Screenshot extraction and media processing | Bundled with the plugin |
ReadyCheck bundles whisper-cli and ffmpeg — Homebrew installs are not required.
Permissions
When you first run a capture, macOS will prompt for:
- Screen Recording — for capturing the screen
- Microphone — for recording voice narration
These permissions are requested at runtime, not during installation. Grant both for full functionality.
Troubleshooting
If something isn’t working, run /doctor first. It identifies what’s missing and provides fix commands.
Common issues:
- “Frida agent not found” — The plugin installation may be incomplete. Try reinstalling.
- “Whisper not found” — Reinstall the plugin.
- “FFmpeg not found” — Reinstall the plugin.
- Capture stops immediately — Check that Screen Recording permission has been granted in System Settings → Privacy & Security → Screen Recording.
- No voice transcript — Check that Microphone access has been granted in System Settings → Privacy & Security → Microphone.