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

# Troubleshooting

> Quick index of setup, run, and Test Studio issues—jump to the page that matches your symptom.

## Device & Setup Issues

[**→ Connecting Devices & Setup**](/reference/troubleshooting/device-and-connection-issues)

Start here if you cannot get a device to appear in Quash, or if Mahoraga is not configuring correctly on a physical device. Covers:

* Device not appearing after "Scan for devices"
* Mahoraga accessibility service won't enable
* Bounding boxes misaligned on physical devices
* Cloud devices showing as busy or auto-disconnecting
* Android emulator or iOS simulator not detected
* WDA Install Error
* Command line Error

## Test Run Issues

[**→ Test Runs & Results**](/reference/troubleshooting/test-execution-failures)

Start here if a test starts but does not complete as expected, returns inconsistent results, or produces no report. Covers:

* Understanding Partial Success, Failure, and inconsistent outcomes
* Tests passing locally but failing in CI
* Flaky tests (inconsistent pass/fail without code changes)
* Agent tapping in the wrong location
* Credentials not working during runs
* Run completing but report is empty or missing

## Test Studio & Recipe Issues

[**→ Test Studio & Megumi Agent**](/reference/troubleshooting/test-studio-issues)

Start here if the Recipe agent is generating poor-quality tests, losing context between prompts, or not updating the Tests panel as expected. Covers:

* Recipe generating generic tests with no app-specific detail
* Recipe not remembering previous session context
* `/compact` not working as expected
* Tests panel not updating after a prompt
* Figma attachments not providing context
* Recipe producing duplicate test cases

If you have worked through the relevant page and the issue is not resolved, contact support with your run ID or a description of the problem.