Skip to content

Obsidian Plugin

Jump to bottom
Rahil Pirani edited this page Aug 29, 2026 · 3 revisions

The Second Brain Sync plugin lets you sync Obsidian notes directly to your Second Brain. Search your brain from inside Obsidian via the sidebar panel.

Plugin repo: second-brain-obsidian-plugin

Install

From Obsidian Community Plugins (recommended)

  1. Open Obsidian → Settings → Community Plugins → Browse
  2. Search for Second Brain Sync
  3. Click Install → Enable

Via BRAT (for early access)

  1. Install BRAT from Community Plugins
  2. Open BRAT settings → Add Beta Plugin
  3. Enter https://github.com/rahilp/second-brain-obsidian-plugin

Manual

  1. Download main.js and manifest.json from the latest release
  2. Copy both files into .obsidian/plugins/second-brain-sync/ in your vault
  3. Enable in Settings → Community Plugins

Configure

Go to Settings → Second Brain Sync:

Setting Description Default
Worker URL Your Cloudflare Worker URL —
Auth token Owner AUTH_TOKEN, or your individual team-member token —
Sync mode Tagged notes only, or all notes Tagged only
Sync tag Frontmatter tag that marks a note for sync brain
Auto-sync on save Sync automatically when you save a tagged note Off
Chunk size Max characters per chunk 1600
Chunk overlap Overlap between chunks 200
Show sync status Last sync time in the status bar On

Click Test after entering your URL and token to verify the connection before syncing.

On a team brain, every person should configure the plugin with their own token. Synced notes belong to that identity and follow its effective capture default; sidebar search covers that person's private layer plus the company layer. Do not share the owner's password between vaults.

Tag notes for sync

Add the sync tag to any note's frontmatter:

---
tags:
  - brain
---

Your note content starts here.

Obsidian renders frontmatter as a properties panel at the top of the note. You can also add it via the UI — click the + button in the properties panel and add a tags property.

Sync

  • Ribbon icon — click the brain icon in the left sidebar to sync the active note
  • Command palette — Cmd+P → "Sync current note to Second Brain"
  • Sync all — Settings → Second Brain Sync → Sync now button
  • Auto-sync — enable in settings to sync tagged notes on every save

Sidebar search

Click the search ribbon icon or run "Open Second Brain search" from the command palette. A sidebar panel opens with a search box that queries your Worker's semantic search directly from inside Obsidian.

Requirements

  • Obsidian v1.7.2 or later
  • A deployed Second Brain Worker

Clone this wiki locally