Troubleshooting

ADB pairing fails

Symptom: The app says "Pairing failed" or "Connection refused."

Solutions:

1. Make sure Wireless debugging is enabled in Developer options
2. Make sure you're pairing with the Pairing port, not the connection port — they are different
3. Try disabling and re-enabling Wireless debugging
4. Restart the app and try again

App says "No backend connected"

Symptom: The app opens but shows no ADB connection.

Solutions:

1. Check that Wireless debugging is still enabled (some OEMs disable it on reboot)
2. Re-pair using the setup wizard
3. If you previously connected via USB, disconnect the cable and re-pair wirelessly

AI doesn't respond or gives wrong actions

Symptom: The AI seems stuck, repeats the same action, or ignores UI elements.

Solutions:

1. Check your LLM configuration (Settings → LLM Provider) — verify the base URL and API key
2. Try a different model — some models handle tool calling better than others
3. See Supported Models for recommended models

Screenshots are black or blank

Symptom: The AI operates but the screenshots it sees are empty.

Solutions:

1. Standard mode captures screenshots via Mirror VD + ImageReader — if the virtual display isn't running, restart the app
2. Some apps use FLAG_SECURE which blocks screenshot capture in standard mode
3. System App mode uses SurfaceControl which bypasses FLAG_SECURE

More Help

Open an issue on GitHub with your device model, Android version, and log output.