# Yoqa

> Local-first agentic mobile QA — test iOS and Android apps with AI, no locator scripts.

## Docs

- [Overview](https://yoqa.mintlify.app/docs/overview.md): Everything you need to test your mobile apps with AI.
- [Quickstart](https://yoqa.mintlify.app/docs/quickstart.md): Create test cases, connect a device, run tests, and review results.
- [Apps](https://yoqa.mintlify.app/docs/apps.md): Manage iOS and Android applications for local agentic testing.
- [Test Cases](https://yoqa.mintlify.app/docs/test-cases.md): Use natural language instructions for the AI agent.
- [Desktop application](https://yoqa.mintlify.app/docs/desktop-app.md): Set up and run Yoqa in local mode on macOS.
- [Local Builds](https://yoqa.mintlify.app/docs/local-builds.md): Register and install local .ipa, .app, and .apk builds for testing.
- [Device Preparation](https://yoqa.mintlify.app/docs/device-preparation.md): Prepare iOS and Android devices for local testing with Yoqa.
- [CLI](https://yoqa.mintlify.app/docs/cli.md): Drive Yoqa from your terminal — devices, screen, actions, catalog, and runs.
- [GitHub Actions](https://yoqa.mintlify.app/docs/github-actions.md): Run yoqa in CI and publish the same HTML report as the desktop app.
- [Manual Inspector](https://yoqa.mintlify.app/docs/manual-inspector.md): Explore the device UI, build shell scripts, and save actions without writing locator code.
- [AI Providers](https://yoqa.mintlify.app/docs/providers.md): Bring your own vision models for agent runs and description grounding.
- [Introduction](https://yoqa.mintlify.app/guide/introduction.md): What agentic QA is, why visual testing is different, and who Yoqa is for.
- [How Yoqa agent works](https://yoqa.mintlify.app/guide/how-yoqa-agent-works.md): The perception–decision–action loop, available actions, speed, and limitations.
- [Writing Good Test Cases](https://yoqa.mintlify.app/guide/writing-test-cases.md): How to write test cases that the agent can execute reliably.
- [Local testing](https://yoqa.mintlify.app/guide/local-testing.md): Run Yoqa entirely on your Mac with local devices and BYO models.
- [CLI for agents](https://yoqa.mintlify.app/guide/cli-for-agents.md): Let a coding agent drive the Yoqa CLI — read the screen, debug on device, and author test cases.
- [Cross-Platform Apps](https://yoqa.mintlify.app/guide/best-practices-cross-platform.md): Best practices for testing apps on both iOS and Android with Yoqa.
- [Games](https://yoqa.mintlify.app/guide/best-practices-games.md): Best practices for testing games with Yoqa.
- [In-App Purchases](https://yoqa.mintlify.app/guide/best-practices-iap.md): Testing in-app purchases with Yoqa.
- [Cross-App Flows](https://yoqa.mintlify.app/guide/best-practices-cross-app.md): Testing flows that leave your app (browser, OS settings, other apps).
- [Non-Native UI](https://yoqa.mintlify.app/guide/best-practices-non-native-ui.md): Testing apps with WebViews, canvas, and custom-drawn UI.
- [App State Management](https://yoqa.mintlify.app/guide/best-practices-app-state.md): Managing app state before and during tests.
- [Appium Capabilities](https://yoqa.mintlify.app/guide/best-practices-appium-capabilities.md): Pass custom Appium capabilities to control how the app starts.