> ## Documentation Index
> Fetch the complete documentation index at: https://yoqa.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# 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.

<Steps>
  <Step title="Write your test in plain English">
    Describe the steps and what you expect to see — no code needed.
  </Step>

  <Step title="Choose a device">
    Real device or simulator on your Mac (iOS or Android).
  </Step>

  <Step title="Point to your build">
    A local `.ipa`, `.app`, or `.apk` — or an app already installed on the device.
  </Step>

  <Step title="Run the test">
    Start the run and the agent takes over — it reads the screen and executes each step automatically.
  </Step>

  <Step title="Review the report">
    Screenshots, agent steps, thoughts, and a pass/fail result — export HTML or Markdown when you need to share.
  </Step>
</Steps>

## 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](/docs/providers).

## Roadmap

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

<CardGroup cols={2}>
  <Card title="Quickstart" icon="rocket" href="/docs/quickstart">
    Run your first test in minutes
  </Card>

  <Card title="Guide" icon="book-open" href="/guide/how-yoqa-agent-works">
    Learn how the agent thinks and write better tests
  </Card>

  <Card title="Local testing" icon="desktop" href="/docs/desktop-app">
    Test on your Mac with local devices
  </Card>

  <Card title="CLI for agents" icon="terminal" href="/guide/cli-for-agents">
    Let Cursor / Claude drive the device
  </Card>
</CardGroup>