setup

Second Brain Setup

Configure vault paths and scaffold vault CLAUDE.md.

For sb CLI details, see references/sb-cli.md.

Step 1: Check Existing Config

Check if vaults are already configured:

npx @techpickles/sb config vaults

This returns JSON with configured vaults.

If this fails, run ${CLAUDE_PLUGIN_ROOT}/scripts/diagnose-sb.sh for a one-shot diagnosis rather than re-deriving the checks by hand.

If vaults exist, show current and ask:

• Add another vault?
• Reconfigure existing vault?
• Cancel

Step 2: Get Vault Path

Ask user for vault path. No assumed locations, just ask directly:

"Where is your Obsidian vault located? (full path)"

Step 3: Validate Vault

Check the path exists:

ls -d "{path}" 2>/dev/null

Parse .obsidian config (if present):

npx @techpickles/sb vault obsidian --path "{path}"

This outputs JSON with:

• Daily notes folder and template
• Templates folder
• Inbox/new notes folder
• Attachments folder

If .obsidian/ missing, sb will indicate this in the output:

• Might not be an Obsidian vault
• Offer to continue anyway (for plain markdown repos)
• Or user can open folder in Obsidian first to initialize

Step 4: Confirm Settings

Show detected settings from the sb output:

Detected from .obsidian/:
- Daily notes: Fleeting/ (template: Templates/daily)
- Templates: Templates/
- Inbox: 📫 Inbox/
- Attachments: 🖇 Attachments/

Does this look right? [Yes] [Adjust]

Step 5: Name the Vault

Ask for short identifier:

"What should I call this vault? (e.g., primary, work, personal)"

Suggest "primary" if this is the first vault.

Step 6: Initialize Configuration

Create or update ~/.claude/second-brain.md:

npx @techpickles/sb init --name "{name}" --path "{path}"

Add --scaffold flag if user wants to create vault CLAUDE.md:

npx @techpickles/sb init --name "{name}" --path "{path}" --scaffold

This command:

• Writes the vault configuration to ~/.claude/second-brain.md
• Optionally creates {vault}/CLAUDE.md with detected settings