Vault

The vault is an optional folder on disk where Fluister mirrors your profiles, vocabulary, and (soon) dictations as plain markdown files.

If you have an Obsidian or BBEdit setup, point Fluister at it: Settings → Storage → Set vault folder.

Layout

vault/
├── profiles/
│   ├── default.md
│   ├── email.md
│   └── chat.md
└── vocabulary/
    └── terms.md

Each file has YAML frontmatter (the structured fields) plus optional markdown body. ULIDs are used as primary keys so the files survive sync, rebuilds, and multi-machine use.

Why use a vault

• Edit profiles in your text editor instead of through the Settings UI.
• Sync between Macs via iCloud Drive, Dropbox, or a git repo.
• Back up via Time Machine like any other folder.
• Read your data with cat. No SQLite migration ever locks you in.

The vault is optional. Without one, Fluister keeps everything in its private SQLite database at ~/Library/Application Support/Fluister/fluister.db.