Overview

Everything you need to test your mobile apps with AI.

Yoqa is an AI agent that tests your apps and games visually — no locator scripts required. Phase 1 is local-first: run on your Mac with simulators and devices you already own, using your own AI provider keys.

1. Write your test in plain English

   Describe the steps and what you expect to see — no code needed.

2. Choose a device

   Real device or simulator on your Mac (iOS or Android).

3. Point to your build

   A local .ipa, .app, or .apk — or an app already installed on the device.

4. Run the test

   Start the run and the agent takes over — it reads the screen and executes each step automatically.

5. Review the report

   Screenshots, agent steps, thoughts, and a pass/fail result — export HTML or Markdown when you need to share.

Two ways to drive the device

Mode	Who decides each step	Best for
Device connector (CLI)	Your coding agent (yoqa screen → yoqa action)	Debugging a feature you just built
Yoqa agent (runs)	Yoqa’s perception → decision → action loop	Smoke / regression on saved test cases

Both modes use Appium under the hood (XCUITest on iOS, UiAutomator2 on Android). You bring your own vision model via AI Providers.

Roadmap

Cloud device farm, public API, and CI/CD hosting are planned for later. Today everything runs locally on your machine.

Quickstart

Run your first test in minutes

Guide

Learn how the agent thinks and write better tests

Local testing

Test on your Mac with local devices

CLI for agents

Let Cursor / Claude drive the device