Desktop troubleshooting

Local engine unavailable

Symptoms: Startup Failed, an engine version mismatch, a local 404, or the app remaining on a loading state.

1. 1
   Recover

   Choose Restart and retry.

2. 2
   Wait

   OpenSS stops confirmed OpenSS engine processes, launches the bundled engine and checks /api/version.

3. 3
   Report

   If recovery still fails, include the desktop version, macOS version and safe error text—never account tokens or provider keys.

Signed in but hosted AI returns 401

Refresh Account first. If /api/me works but chat fails, restart the engine so the desktop token-to-upstream forwarding path is recreated. Repeated sign-in is not useful when the account snapshot is already valid.

Capture fails

• Confirm Chrome, Word or PowerPoint is running.
• Bring the target and OpenSS to the expected display.
• Check System Settings → Privacy & Security → Screen Recording.
• For PowerPoint full slide, enter Slide Show mode.

Voice fails

• Check Microphone and Speech Recognition permissions.
• If on-device recognition is unavailable, type instead; OpenSS does not use a cloud fallback.
• If OpenSS heard too little speech, speak after the listening state appears and avoid covering the microphone.