Omniscio

Plugin access to your Vault

A plugin you approve can search, open, add, edit, rename and move the notes in the Vault folders you pick, never more than you could do yourself. Deleting a note always asks you first, and the note goes to the Vault trash where you can restore it. Notes you hid, the trash and the app's own folders are never shared. It is off until you turn on Plugin access to your Vault in Settings → Labs, and it only works while your Vault is turned on.

On this page

What it is

A plugin can ask for two permissions, shown on its install card:

Permission What it lets the plugin do
Vault notes (vault.read) Search, list and open the notes in the Vault folders you share.
Change Vault notes (vault.write) Add, edit, rename, move and delete notes in the Vault folders you share. Deleting asks you first.

A plugin that asks to change notes must also ask to read them, so the card always shows everything it holds. The change permission is marked as elevated.

Where to find it

  • The switch: Settings → Labs → Plugin access to your Vault. It starts off and hidden. It also needs the Vault itself to be turned on and set up. With either one off, every Vault ability from a plugin is refused.
  • Sharing: when a plugin needs your notes, a picker opens titled Share Vault notes with (plugin). Tick single folders, or All your notes, including new ones, which covers every note you have now or add later. A folder covers everything inside it, including folders you make inside it later.
  • Review and revoke: Settings → Plugins → the plugin's card lists every Vault folder it can use (or "All your notes") with a Revoke button, and every note it added, edited, renamed, moved or deleted. This panel is on the desktop app only.

What a plugin can and cannot do

  • Can: search your notes by their words, list the notes in a shared folder, open one note and read its text, add a note, replace a note's text, rename a note, move a note to another shared folder, and delete a note after you say yes.
  • Cannot: see a note outside the folders you picked, see notes you hid, see the Vault trash, the assets folder, images or the app's own folders (even inside a picked folder, even with "All your notes"), use AI summaries or the meaning-based search (the plugin gets the plain word search only), or change anything about the Vault itself.
  • Moving: a move needs both the folder the note leaves and the folder it enters to be shared.
  • Names: a note name cannot contain slashes and is at most 200 characters. A new note or a move can go into a new subfolder of a folder you shared, never outside the shared folders.

How it behaves

  • Nothing is shared until you pick it. A plugin asking about a note outside what you shared gets the same "not found" answer as for a note that does not exist.
  • Your edits are protected. A plugin must say when it last read a note before it changes the note's text. If you (or anything else) changed the note since, the plugin's edit is refused as a conflict and nothing changes.
  • Deleting a note shows a question written by Omniscio from its own records: which plugin and which note, and that it moves to the Vault trash. Saying no, closing the dialog, or not answering means nothing changes. Adding, editing, renaming and moving run without asking, because they reach no one else and can be undone from the note's version history.
  • A change goes through the same path as the Vault editor, with the same path safety, size limit and version history. Renaming a note keeps the app's normal link updates, so links in your other notes keep working. The plugin is shown nothing from those other notes.
  • Open Vault screens update on their own when a plugin changes a note, so you never type over a plugin's edit without seeing it first.
  • Your picks belong to the Vault you picked them for. If you point the app at a different Vault folder, the old picks do nothing there and the plugin has to ask again.
  • A plugin never spends Omniscio's money or sees passwords, keys or tokens. Its panel cannot read your notes; only its background program can, through Omniscio.
  • A plugin can make at most 60 reads and 10 changes a minute, shared with its other work data.
  • Revoking, turning the plugin off or uninstalling it stops its very next call, with no restart.

Limits

  • Search: up to 50 results (20 if the plugin does not say), looking for the plain words only. If a plugin shares only a few folders it may get fewer results than it asked for.
  • Listing: up to 100 notes a page (50 by default), in path order.
  • A note's text is returned up to 5 MB. A larger note comes back with its text left out and marked as too large.

Speed cost

Not measured yet. The feature adds no background work of its own (no timer, poller or watcher); it only does work when a plugin calls it, and each call is capped at 60 reads and 10 changes a minute. Search looks at no more than 200 candidate results per call. The off-and-on measurement in the shared Speed Cost Format needs a plugin that actually uses these permissions, and is owed before the feature goes to dogfood.

Plugin access to boards and tasks and Plugin control of your sessions explain the sibling permissions for your boards, task lists and sessions, the Plugin Marketplace page covers installing plugins and the consent card, and Plugin Developer Mode explains how a self-built plugin can use these permissions before the marketplace lists them.

Last verified 2026-11-11