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.
Let one value through
If Omna hides something that isn't private (a false alarm), tell it once:
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:
"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
omna mappingsOpens 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:
| Style | The AI receives | Used for |
|---|---|---|
| Labels (default) | [EMAIL_1] | Everything. Always used for coding agents and anything that writes files |
| Realistic | nancy.moore46@example.com | Chat websites only, where ordinary-looking text can get a better answer |
omna style # what's in use, and where
omna style realistic # switch the browser to realistic fakes
omna style tokens # back to labelsSecrets 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 website | omna hosts add thesite.com |
| Remove a website | omna hosts remove thesite.com |
| Stop covering a tool | omna disable aider (or codex, continue, claude-code) |
| Let one app through untouched (still logged) | omna bypass app "AppName" |
| Cover that app again | omna mask app "AppName" |
| Pause everything | Click 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 files | omna tool-calls secrets on (off by default) |
Start fresh
omna forgetWipes 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.