Omna on your computer
Troubleshooting & removing Omna
Something not working? Start with `omna status` — it says in plain words what's running, what's connected, and anything Omna refused.
My coding tool says it can't connect
Omna isn't running, and that's on purpose: with Omna stopped, nothing goes out unhidden. Start it again:
omna start -dAn app stopped working after install
Some apps only accept their own security certificate ("pinned" apps). Omna refuses to send their traffic unhidden, so they stop. omna status names the app and prints the exact command to let it through untouched:
omna bypass app "AppName"Its traffic then goes as it is — and is still logged, so you can see what wasn't hidden.
Firefox, or a Node / Python / Java program, shows a certificate error
These keep their own list of trusted certificates and ignore the Mac's. Each needs one line, once:
- Firefox: open
about:config, setsecurity.enterprise_roots.enabledtotrue. - Node: set
NODE_EXTRA_CA_CERTS(Omna already does this for VS Code). - Python, Java, Ruby, Deno: see the certificate guide on GitHub.
Safari, Chrome, Edge, Brave and curl need nothing.
An AI website isn't being covered
Omna covers a named list of AI websites, not every site. Add yours:
omna hosts add thesite.comOmna hid something that isn't private
omna allow "the value"One known false alarm: a sentence like "authorization context: something" can look like a secret.
Names inside ordinary sentences aren't hidden
Names written in plain prose are caught by smart masking, which is on by default. Check it's on:
omna smartRight after install, the smart models download in the background. Until they arrive and pass their fingerprint check, messages get fast masking only. omna status says which masking is in use.
If Omna stops while a browser is open
Coding tools fail safely — they can't connect. A browser that already knew Omna's address also fails safely. One that didn't may go direct for a few seconds until Omna restarts itself. If that matters for your work, check omna status after a restart.
Something broke
omna crashShows exactly what broke, with private values already hidden. It stays on your computer. omna crash --send opens a pre-filled report that you read and choose to submit.
Removing Omna
Omna on your computer:
omna uninstallPuts back every setting it changed, removes its certificate and its encryption keys. Installed with Homebrew? Run omna uninstall first, then brew uninstall --cask omna.
Omna for Chrome: open chrome://extensions and click Remove on Omna.
Still stuck?
Tell us — include what omna status says.