bifrost-onboardlisted

# Bifrost Onboarding Walk through full Bifrost setup in Claude Code (steps 1–5), then optionally Claude Desktop (step 6). ## Step 1 — Get your gateway URL and virtual key Ask your gateway operator for two values: - The gateway `/mcp` endpoint URL → `BIFROST_URL` - Your personal virtual key (`vk_…`) → `BIFROST_VK` ## Step 2 — Run the installer From the plugin root (or use the slash command — see below): ```bash export BIFROST_URL=https://<your-gateway-host>/mcp node "${CLAUDE_PLUGIN_ROOT}/bin/install.js" --key vk_<your-key> ``` The installer: - Registers the bifrost MCP server via `claude mcp add --scope user` (idempotent — re-running replaces the same entry; it never edits config files directly). - Without `--key`, stores the `${BIFROST_VK}` runtime template. It does NOT modify your shell profile — you must add `export BIFROST_VK=…` to `~/.zshrc` (or `~/.bashrc`) yourself for the key to persist across sessions. Or run the slash command from inside Claude Code (same installer): ``` /bifrost-setup ``` ## Step 3 — Persist the env vars, then restart Claude Code Add the export lines to your shell profile so they survive new shells: ```bash echo 'export BIFROST_URL=https://<your-gateway-host>/mcp' >> ~/.zshrc # or ~/.bashrc echo 'export BIFROST_VK=vk_<your-key>' >> ~/.zshrc source ~/.zshrc ``` Then restart CC so the MCP server and hooks are loaded. > macOS note: Claude Code launched from the Dock or Spotlight does NOT inherit > `~/.zshrc` exports. Launch CC from a t