Vault Relay Download beta

Documentation

Set up Vault Relay without guesswork.

Install the Obsidian plugin, connect the browser extension, and keep the local bridge narrow enough to understand when something needs troubleshooting.

Requirements

  • Obsidian desktop with Community plugins enabled.
  • Chrome, Chromium, or Firefox 142 or newer.
  • The latest Vault Relay beta packages from GitHub releases.
  • Obsidian must be open while the extension talks to the local bridge.

Install the Obsidian plugin

  1. Download vault-relay-obsidian.zip.
  2. Unzip it into a temporary folder.
  3. Copy main.js, manifest.json, and styles.css into <vault>/.obsidian/plugins/vault-relay/.
  4. Reload Obsidian or restart the app.
  5. Enable Vault Relay from Community plugins.

Install the browser extension

Chrome or Chromium

  1. Download and unzip vault-relay-chrome.zip.
  2. Open chrome://extensions.
  3. Enable Developer mode.
  4. Choose Load unpacked and select the unzipped folder.

Firefox

  1. Download vault-relay-firefox.xpi.
  2. Open Add-ons and themes.
  3. Choose Install Add-on From File and select the XPI.

Connect the local bridge

  1. Open Vault Relay settings in Obsidian.
  2. Enable the local bridge.
  3. Copy the bridge token.
  4. Open Vault Relay extension settings.
  5. Set Bridge URL to http://127.0.0.1:27191.
  6. Paste the token and click Test connection.

Capture workflows

Selected text

Select text on a page, then use the extension or context menu to review it in Obsidian.

Page to ChatGPT

Send page context into ChatGPT with your default prompt rules attached.

ChatGPT answer

Use the Vault Relay button in ChatGPT to save the latest assistant answer as Markdown.

Visible transcript

Export the visible conversation when the complete thread matters more than one response.

Settings worth checking

  • Default folder: where captures go when no folder is suggested.
  • Filename pattern: the generated name before the save modal opens.
  • Conflict mode: numbered copy, append, or overwrite.
  • Frontmatter: optional metadata for source, created date, title, and prompt.
  • Selectors: recovery hooks if ChatGPT changes completion or download UI.

Security model

Vault Relay does not add analytics or cloud storage. The extension sends captures to the Obsidian plugin over localhost and the plugin requires the bridge token before it accepts write requests.

  • The bridge listens on 127.0.0.1.
  • Requests must include the shared token.
  • Origins are checked when the browser provides them.
  • Download clicking is disabled by default.

Troubleshooting

Test connection fails

Check that Obsidian is open, the plugin is enabled, the bridge is on, and the token matches.

ChatGPT capture misses the latest answer

Use the visible transcript fallback, then update selectors if the ChatGPT page changed.

The note path is wrong

Adjust the default folder or edit the destination directly in the Obsidian save modal.