CLI
CLI troubleshooting
Diagnose architecture, provider, capture and update problems.
Run Doctor
Terminal
openss doctor
openss doctor --validate-keys
openss doctor --logs--validate-keys makes live provider calls; omit it when you only need local checks.
Common symptoms
| Symptom | Resolution |
|---|---|
| Virtual environment not found | Re-run the installer or repair the symlink instead of copying the openss launcher. |
| Architecture mismatch | Install native Python 3.12 matching the Mac architecture; avoid an unintended Rosetta interpreter. |
| Provider key rejected | Use openss keys set PROVIDER, then optionally validate with Doctor. |
| Capture target not running | Open Chrome, Word or PowerPoint and retry with an explicit --target. |
| Update failed | The current installation remains available; run openss update again after checking network and logs. |