VaultBridge

Migrate settings from one Obsidian vault to another — interactively, with control over exactly what gets applied.

Install

# npm
npm install -g vaultbridge

# Homebrew (tap)
brew tap rileysheehan/vaultbridge
brew install vaultbridge

Usage

Guided mode

Run with no arguments for an interactive walkthrough:

vaultbridge

Same machine

Copy settings directly from one vault to another:

vaultbridge bridge ~/Iridium ~/Technetium

Different machines

On the source machine, export to a file:

vaultbridge export ~/Iridium iridium-export.json

Transfer iridium-export.json to the target machine, then:

vaultbridge apply iridium-export.json ~/Technetium

How it works

VaultBridge walks through your vault's .obsidian/ directory — root configs (app.json, appearance.json, core-plugins.json, etc.) and each community plugin's data.json — and asks whether to apply each one.

If you say no to a plugin or config section, you can drill in and choose exactly which settings to include (allowlist) or exclude (blocklist).

Path detection: any setting that references a folder path is checked against the target vault's actual folder structure. If the path doesn't exist, VaultBridge offers to remap it before writing.

Skipped always: obsidian-local-rest-api (TLS cert/key must be regenerated) and readwise-official (re-sync from your Readwise account).

Requirements

Node 18+