team-os

Relay Swap — Install BenAI Relay Fork

This skill replaces the upstream Relay plugin (system3-relay) with the BenAI fork (benai-relay-fork) in a target Obsidian vault. The compiled fork ships at ${CLAUDE_PLUGIN_ROOT}/skills/team-os/reference/benai-relay-fork/ (three files: main.js, manifest.json, styles.css). Copy from there — do not fetch from anywhere else.

What the user provides

Just their Obsidian vault folder — the one they open inside Obsidian itself. The skill will auto-detect it if they invoke /team-os from inside the vault, otherwise it'll walk them through finding it via Obsidian's Settings → About → "Show vault folder".

Example paths the user might give: ~/Documents/MyVault, /Users/jane/Obsidian/Work, or a folder dragged from Finder/Explorer. The skill normalizes all of them.

---

Workflow

Step 0 — Confirm intent + locate the vault folder

Tell the user what this will do, in plain language:

I'm about to replace the official Relay plugin with the BenAI fork in your Obsidian vault. The fork has custom RBAC + access controls. This will:

1. Delete the old system3-relay plugin if it's there.
2. Install the bundled BenAI Relay build.
3. Update Obsidian's community-plugins config to switch over.

Close Obsidian first — modifying plugin files while it's running can corrupt the install.

Get the vault folder (no jargon)

Don't ask for an "absolute path". Most users don't think in those terms. Try this order:

1. Try the current working directory first.

If the cwd contains a .obsidian/ folder, ask:

I see this folder ({cwd}) is already an Obsidian vault. Is this the one you want to install BenAI Relay into? (yes / no — I'll ask where it is)

If yes, set VAULT="$(pwd)" and skip to Step 1.

2. Otherwise, ask in plain language with platform-specific hints.

AskUserQuestion framed like:

Where is your Obsidian vault — the folder you open inside Obsidian itself?

Easiest way to find it:

• Open Obsidian → Settings → "About" → click "Show vault folder" (or right-click your vault name in the vault switcher → "Reveal in Finder/Explorer"). Drag that folder into this chat, or copy its path.
• On macOS it usually looks like /Users/yourname/Documents/MyVault or ~/Obsidian/MyVault.
• On Windows it usually looks like C:\Users\yourname\Documents\MyVault.
• The folder you want is the one with a hidden .obsidian subfolder inside it (not the Documents folder above it).