Omna on your computer

Masking controls

Omna works with no setup. When you want to change something — let a value through, hide your own kind of ID, review what was hidden — here is how.

3 min readAllow, add your own, review, choose a style

Let one value through

If Omna hides something that isn't private (a false alarm), tell it once:

sh
omna allow "support@yourcompany.com"

That exact value is never hidden again.


Hide your own kind of data

Your company may have its own IDs — customer numbers, case numbers, project codes. Open ~/.omna/ruleset.json and add a pattern to its custom_rules list:

json
"custom_rules": [
  { "label": "CUSTOMER_ID", "pattern": "ACME-\\d{6}" }
]

From then on, ACME-123456 becomes [CUSTOMER_ID_1]. (Tested on Omna 0.6.25.)


Review what was hidden

sh
omna mappings

Opens a private page on your computer listing every personal value Omna has hidden: which kind it was, how many times it was sent, when, and to which AI. Real values stay hidden until you click Reveal. You can delete one value, or Clear all.

Secrets never appear here — they are kept in memory only and never written down.


Labels or realistic fakes

Omna can write a hidden value two ways:

StyleThe AI receivesUsed for
Labels (default)[EMAIL_1]Everything. Always used for coding agents and anything that writes files
Realisticnancy.moore46@example.comChat websites only, where ordinary-looking text can get a better answer
sh
omna style             # what's in use, and where
omna style realistic   # switch the browser to realistic fakes
omna style tokens      # back to labels

Secrets always stay labels, in every style.


Real values or labels in the browser's answer

By default, the AI's answer in your browser shows your real values. Turn off Restore Real Values in Browser in the menu-bar icon to read the answer with labels instead. Hiding is not affected — it's never optional.

A real value only ever comes back on the same website you typed it into.


Choose what Omna covers

To…Run
Add an AI websiteomna hosts add thesite.com
Remove a websiteomna hosts remove thesite.com
Stop covering a toolomna disable aider (or codex, continue, claude-code)
Let one app through untouched (still logged)omna bypass app "AppName"
Cover that app againomna mask app "AppName"
Pause everythingClick the top line of the menu-bar icon — it turns red and ends by itself after 15 minutes
Let one kind of data through (not secrets)omna categories off PHONE (on to undo)
Turn smart masking off (code only, no personal data)omna smart off (on to undo)
Put secrets back in an agent's commands and filesomna tool-calls secrets on (off by default)

Start fresh

sh
omna forget

Wipes every saved masked label and its encryption key. Personal-data labels start again from [EMAIL_1]. A secret's label number is never reused, even after this.


What's next