​
Setup

  1. Open the macOS app
  2. Go to Integrations
  3. Select your Obsidian vault folder

​
Auto-Sync

The macOS app automatically syncs your vault every 30 minutes when:
  • You’re logged in
  • A vault path is configured
  • The app is running (even minimized to menu bar)

​
Manual Sync

Trigger a sync from the Add to KB section in the macOS app, or use the CLI: 
bestmate deploy --vault /path/to/obsidian-vault

​
What Gets Synced

  • All .md files in the vault
  • Hidden folders (.obsidian, .trash) are skipped
  • Deduplicates based on content hash — unchanged files are skipped
  • Each file becomes a KB article with the filename as title

​
Visibility

By default, Obsidian vault content is ingested as private (only you can query it). To make it org-wide: 
bestmate deploy --vault ./vault  # org-wide by default
bestmate deploy --vault ./vault --vault-private  # keep private