ReferenceStable
System & troubleshooting
Requirements, install and updates, the macOS permissions o8 asks for, and fixes for the common gotchas.
Requirements
o8 is a native macOS app — a Next.js front end inside a Tauri shell, not a web app or Electron.
- macOS 14 or later.
- Intel or Apple Silicon — o8 ships one signed Intel build. On Apple Silicon it currently runs under Rosetta; a native arm64 build is on the way.
Install & updates
Download the .dmg from o8.run/download, drag o8 to Applications, and on first launch right-click the app → Open (the standard one-time macOS step). After that, o8 auto-updates — it checks for new releases and applies them in the background, and every update is signed and verified before it's trusted, so you stay current without doing anything.
Permissions
If you use voice (Symon / dictation), o8 asks for a few macOS permissions — one-time grants in System Settings → Privacy & Security:
| Permission | Why |
|---|---|
| Accessibility | To capture the global push-to-talk hotkey and paste dictated text into whatever app you're in. |
| Input Monitoring | A separate, stricter grant so the hotkey actually receives key events. Both this and Accessibility must be on. |
| Microphone | To hear you, for dictation and Symon. |
You only need these if you use voice; the rest of o8 works without them.
Troubleshooting
o8: command not found— theo8CLI is a symlink o8 installs on launch. If it's missing, relaunch the o8 app once (it re-creates the link), then open a fresh terminal.- The app won't open on first launch — right-click → Open instead of double-clicking, to clear the one-time macOS prompt.
- The voice hotkey does nothing — check that both Accessibility and Input Monitoring are enabled (they're separate toggles), then relaunch o8 so it picks up the grant.
- Dictation is silent — Microphone was likely denied; re-enable it in System Settings → Privacy & Security → Microphone.