System & troubleshooting
Platform status, install and updates, macOS permissions, and fixes for the common gotchas.
The product files tracked by this page changed after o8 v0.1.664. Use this as a dated reference while the current documentation is refreshed.
Requirements
o8 is a native desktop app — a Next.js front end inside a Tauri shell, not a web app or Electron.
- macOS 14 or later: the signed public release is Intel and currently runs on Apple Silicon under Rosetta.
- Windows 11: runtime-verified public MSI and EXE previews. Checksums and GitHub build attestations are published; Authenticode publisher signing and updates remain open.
- Linux: public AppImage, deb, and rpm previews. Checksums and GitHub build attestations are published, and the AppImage has an embedded GPG signature; desktop verification, update delivery, and a supported distribution floor remain open.
Install & updates
Choose a platform at o8.run/download. On macOS, download the .dmg, drag o8 to Applications, and on first launch right-click the app → Open (the standard one-time macOS step). The macOS build auto-updates and verifies every signed update before applying it. Windows and Linux installers are public previews for early testing and do not have an automatic update channel yet.
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.