The vault plugin opens the directory olai serves. Every other plugin that reads or writes a file needs it.1
What turns it off
This plugin runs in every profile. Its switch, Vault under Notes in the plugins panel, lasts only until olai restarts, and the panel says This switch resets when olai restarts.2
The panel asks before switching it off.3
With it off, olai serves no files, every plugin that needs them stops, and the tools that reach into the directory refuse and say why.4
Settings
| Key | Default | What it does |
|---|---|---|
format |
outline-olai |
The plugin whose file kind olai uses when it creates a new outline |
A file already on disk is read by whichever plugin claims its kind, whatever format says.5
What it refuses
| What happens | What you get |
|---|---|
| another olai already has this directory open | this plugin fails and the panel says so; the connections keep running, so you can free the directory and switch it on again |
| the path is not a directory | the same: a failed plugin, and a serve you can try again from |
format names a plugin that is not running |
the directory stays readable, and creating a new outline is refused before anything is written |
What is missing without git or search
Two of the vault’s answers come from other plugins: what records your writes, and what a search finds.6
| Plugin | Without it |
|---|---|
git (The git plugin: commits, pushes and its two settings) |
writes land on disk and nobody records them: nobody is recording writes here, so there is nobody to record a write |
search (The search plugin: the index and the search box) |
every query answers with no hits and the reason, naming the plugin |
See Switch olai's plugins on and off for choosing what runs, and The plugin system for how a plugin starts and stops.
Footnotes
-
What this plugin does with the directory: it claims the directory so that no second olai opens it, watches the files for changes, checks every write before it happens, and publishes a new revision whenever anything changes. ↩
-
Why the switch lasts only for the session: the settings file lives inside the directory this plugin opens. The settings plugin, and the plugin that reads the settings file’s kind, last only for the session for the same reason (Switch olai's plugins on and off). ↩
-
Switching the vault off and on again: the question the panel asks says that switching it off clears the files olai is serving and stops the plugins that need them. Writes olai has already accepted finish before it stops watching the files and lets go of the directory, and switching it on opens the same directory afresh. ↩
-
The listener, the websocket and
/mcpstay up with the vault off, so you can switch it back on from the panel. ↩ -
A file no plugin claims is not served at all. ↩
-
When neither
gitnorsearchis running, the vault answers both of these itself. ↩