1
Start Yoqa
Download the Apple Silicon DMG from GitHub Releases and drag The bundled runner starts automatically on Confirm with
yoqa.app to /Applications. The DMG is unsigned, so recent macOS versions show “yoqa” is damaged and can’t be opened on first launch. Clear the quarantine attribute once, then open the app:http://127.0.0.1:7420.Running from a monorepo checkout instead? Start both processes manually:yoqa health after installing the CLI (Settings → CLI & Agents).2
Configure an AI provider
Open Settings → Providers, add a key (Anthropic, OpenAI, Groq, Google, Cursor, Grok, OpenCode, or a custom OpenAI-compatible endpoint), validate, and set it as default. See AI Providers.
3
Add an app
In the desktop app, create an app with a name and iOS bundle ID and/or Android package name. Note the short prefix — CLI catalog commands use it.
4
Create test cases
Add a case with a title, natural-language instructions, and an optional expected result. Repeat for more coverage. Tips: Writing good test cases.
5
Prepare a device
Boot an iOS Simulator / Android emulator, or connect a physical device. Complete Device preparation (Xcode / adb / WDA as needed).
6
Select cases and run
Pick the device, optional local build, and one or more cases — then Run. The agent executes each flow from screenshots.
7
Review results
Open Runs for live progress, per-step status, expandable AI thoughts, and screenshots. Export an HTML or Markdown report when you want to share.
What’s next?
Test cases
How cases, flows, and tags work
CLI
Drive Yoqa from the terminal