Vault
A read only reader for your Obsidian vault. It reads a mirror pulled onto the card, follows wikilinks, and searches names and full text.
- Home key: v
- Needs: Works with nothing
- Refresh: Pull from your server
- Offline: Reads the whole mirror
Before the first sync there is no mirror, and Vault says so.
What it does
Vault puts your wiki in your pocket. It opens on the catalogue and renders headings, lists and wikilinks. Follow a link to the page it names, or search by filename and by text. It never writes to the mirror.
Keys
| Key | Does |
|---|---|
| Tab | Move to the next wikilink on the page. Alt+Enter is Tab. |
| Enter | Follow the selected link. |
| / | Search: page names first, then page text. |
| i | Open the catalogue page. |
| s | Pull a fresh mirror, when there is none yet. |
| Back | Previous page. |
How the mirror works
A sync runs rsync from your server through the gate, pulling wiki/, the catalogue files at the vault root, profile.md and CLAUDE.md. rsync sends only what changed, so a sync with nothing new takes about a second. The filename index is built once per pull, not every time you open the app.
If a link points to a page the mirror does not have, Vault says it is not in the mirror, rather than showing an old copy or nothing.
Needs
An Obsidian vault with a wiki/ folder and the root files PennyOS expects. See Working with Obsidian.