Troubleshooting

Reflex always tells you in plain words why something didn't work and how to fix it. These are the common cases.

“I can't see or control … because Accessibility permission is off”

Open System Settings → Privacy & Security → Accessibility and turn on Reflex. If it's already on but Reflex still can't see apps (this can happen after an update), turn it off and on again, or remove Reflex from the list with − and add it back with +.

“The local AI model isn't available”

Open Settings → AI models. Qwen3-0.6B is included with Reflex; Qwen3-4B is downloaded once (or imported with Import file…). Settings → Diagnostics → Run Local AI Test runs a real test of both models on your computer and shows what's wrong.

“Chrome isn't connected to Reflex”

The browser extension isn't paired or the browser is closed. Reflex still works in the browser through accessibility; for the most precise web automation, open Settings → Browser extension → Pair and enter the code in the Reflex extension popup.

The task bar doesn't open

Another app may use ⌥ Space. Reflex picks a free shortcut automatically and shows it in Settings → General — you can record any shortcut there. You can also click the Reflex icon in the menu bar / tray.

Voice doesn't hear me

Check System Settings → Privacy & Security → Microphone → Reflex (macOS) and your input device. Settings → Diagnostics shows whether the on-device speech model is ready.

Reflex stopped and asked me something

That's deliberate: Reflex asks before sensitive steps and when a request is ambiguous and a wrong guess could cause harm. Answer in the card (or out loud) and it continues.

macOS says the app is damaged or can't be opened

Current builds aren't notarized yet. See Installation → macOS: use Open Anyway in Privacy & Security, or run xattr -cr /Applications/Reflex.app.

Where are the logs?

Settings → Privacy & audit shows the audit log. Files are in ~/Library/Application Support/Reflex/logs (macOS), %APPDATA%\Reflex\logs (Windows) or ~/.config/Reflex/logs (Linux). They never contain passwords or what you typed into fields.

Still stuck?

Email support@waspid.com with what you asked Reflex to do and the message it showed. Settings → Diagnostics has everything we'd ask about.