Troubleshooting

Install & launch

macOS “damaged” or unsigned developer

1. Download from official channels
2. System Settings → Privacy & Security → Open anyway
3. Verify complete download (file size)

Windows SmartScreen

See Installation — Windows. Re-download from GitHub Releases.

Blank window or crash on start

1. Quit fully and relaunch
2. Check AV blocking Electron
3. Clear app cache in user data (backup workspace first)
4. File GitHub Issues with OS version and logs

AI providers

Connection test fails

• Expired key or IP allowlist
• Wrong base URL
• Corporate HTTPS proxy

Empty model list

• Provider must pass connection test first
• Some gateways need manual model IDs

Mobile

Android device not listed

adb devices

• USB debugging on
• Try another cable/port
• OEM drivers on Windows

iOS

• Host must be macOS
• Xcode CLT installed
• Trust this computer on device

HarmonyOS

• Follow official debug toolchain docs
• Check device authorization

Ember Cloud

ember-mcp doctor fails

• EMBER_API_URL reachable?
• Re-run ember-mcp login
• Match EMBER_DEBUG_TEMPLATE_ID with lmweb

UI-Genie timeout

• Device busy?
• Split long NL instructions
• Ask admin for uiagent logs

Docs site

Run npm run build in this repo for MDX compile errors.

Desktop: GitHub Issues. Cloud: contact your tenant admin.