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.

2 min readFixes, and removing Omna

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:

sh
omna start -d

An 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:

sh
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, set security.enterprise_roots.enabled to true.
  • 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:

sh
omna hosts add thesite.com

Omna hid something that isn't private

sh
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:

sh
omna smart

Right 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

sh
omna crash

Shows 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:

sh
omna uninstall

Puts 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.


What's next