feat: auto-start Brain + auto-register Claude Code MCP

1. Orb (Tauri Rust): spawns Brain Lite WebSocket server on app start
   - Detects ~/.jarvis-orb/jarvis_brain, launches python -m jarvis_brain.demo_server
   - Falls back to standalone mode if Brain not installed
   - Works on macOS + Windows

2. Installers: auto-register MCP in Claude Code settings.json
   - macOS: Python script modifies settings.json
   - Windows: PowerShell modifies settings.json
   - Both: graceful fallback to manual instructions if auto-config fails

User flow: install → open Orb → everything works. No manual steps.

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>

Author: thestack_ai

install.ps1

@@ -80,19 +80,46 @@ Write-Ok "Brain launcher → $BrainBin\jarvis-brain.bat"
 # ── Step 3: Claude Code MCP ──
 Write-Step "Configuring Claude Code"
 
-$claudeSettings = "$env:USERPROFILE\.claude\settings.json"
+$claudeDir = "$env:USERPROFILE\.claude"
+$claudeSettings = "$claudeDir\settings.json"
+
 if (Test-Path $claudeSettings) {
     $content = Get-Content $claudeSettings -Raw
     if ($content -match "jarvis-brain") {
         Write-Ok "Already configured"
     } else {
-        Write-Info "Add to your Claude Code MCP config:"
-        Write-Host ""
-        Write-Host '    "jarvis-brain": {' -ForegroundColor White
-        Write-Host "      `"command`": `"$BrainBin\jarvis-brain.bat`"" -ForegroundColor White
-        Write-Host '    }' -ForegroundColor White
-        Write-Host ""
+        try {
+            $settings = $content | ConvertFrom-Json
+            # Add mcpServers if not exists
+            if (-not $settings.mcpServers) {
+                $settings | Add-Member -NotePropertyName "mcpServers" -NotePropertyValue @{} -Force
+            }
+            $brainCmd = "$BrainBin\jarvis-brain.bat"
+            $settings.mcpServers | Add-Member -NotePropertyName "jarvis-brain" -NotePropertyValue @{
+                command = $brainCmd
+            } -Force
+            $settings | ConvertTo-Json -Depth 10 | Set-Content $claudeSettings -Encoding UTF8
+            Write-Ok "MCP server registered in Claude Code"
+        } catch {
+            Write-Info "Add to your Claude Code MCP config:"
+            Write-Host ""
+            Write-Host '    "jarvis-brain": {' -ForegroundColor White
+            Write-Host "      `"command`": `"$BrainBin\jarvis-brain.bat`"" -ForegroundColor White
+            Write-Host '    }' -ForegroundColor White
+            Write-Host ""
+        }
+    }
+} elseif (Test-Path $claudeDir) {
+    # settings.json doesn't exist but .claude dir does — create it
+    $newSettings = @{
+        mcpServers = @{
+            "jarvis-brain" = @{
+                command = "$BrainBin\jarvis-brain.bat"
+            }
+        }
     }
+    $newSettings | ConvertTo-Json -Depth 10 | Set-Content $claudeSettings -Encoding UTF8
+    Write-Ok "Created Claude Code settings with MCP config"
 } else {
     Write-Info "Claude Code not found — configure MCP manually after install"
 }

install.sh

@@ -119,12 +119,29 @@ if [ -d "$CLAUDE_DIR" ]; then
   if grep -q "jarvis-brain" "$CLAUDE_SETTINGS" 2>/dev/null; then
     ok "Already configured"
   else
-    info "Add to your Claude Code MCP config:"
-    echo ""
-    echo -e "    ${WHITE}\"jarvis-brain\": {${R}"
-    echo -e "    ${WHITE}  \"command\": \"$BRAIN_BIN/jarvis-brain\"${R}"
-    echo -e "    ${WHITE}}${R}"
-    echo ""
+    if [ -f "$CLAUDE_SETTINGS" ] && command -v python3 &>/dev/null; then
+      python3 -c "
+import json, sys
+try:
+    with open('$CLAUDE_SETTINGS') as f:
+        s = json.load(f)
+    if 'mcpServers' not in s:
+        s['mcpServers'] = {}
+    s['mcpServers']['jarvis-brain'] = {'command': '$BRAIN_BIN/jarvis-brain'}
+    with open('$CLAUDE_SETTINGS', 'w') as f:
+        json.dump(s, f, indent=2, ensure_ascii=False)
+    print('done')
+except Exception as e:
+    print(f'fail:{e}', file=sys.stderr)
+    sys.exit(1)
+" 2>/dev/null && ok "MCP server registered in Claude Code" || {
+        info "Add to your Claude Code MCP config:"
+        echo -e "    ${WHITE}\"jarvis-brain\": { \"command\": \"$BRAIN_BIN/jarvis-brain\" }${R}"
+      }
+    else
+      info "Add to your Claude Code MCP config:"
+      echo -e "    ${WHITE}\"jarvis-brain\": { \"command\": \"$BRAIN_BIN/jarvis-brain\" }${R}"
+    fi
   fi
 else
   info "Claude Code not found — configure MCP manually after install"

orb/src-tauri/Cargo.lock

@@ -7,6 +7,7 @@ edition = "2021"
 tauri = { version = "2", features = [] }
 serde = { version = "1", features = ["derive"] }
 serde_json = "1"
+dirs = "6"
 
 [build-dependencies]
 tauri-build = { version = "2", features = [] }

orb/src-tauri/Cargo.toml

@@ -1,6 +1,53 @@
 #![cfg_attr(not(debug_assertions), windows_subsystem = "windows")]
 
+use std::process::Command;
+
+fn start_brain() {
+    let home = dirs::home_dir().unwrap_or_default();
+    let brain_dir = home.join(".jarvis-orb");
+    let brain_module = brain_dir.join("jarvis_brain");
+
+    // Only start if brain is installed
+    if !brain_module.exists() {
+        eprintln!("[Orb] Brain not found at {:?}, running in standalone mode", brain_module);
+        return;
+    }
+
+    let lib_dir = brain_dir.join("lib");
+    let pythonpath = format!(
+        "{}{}{}",
+        lib_dir.display(),
+        if cfg!(windows) { ";" } else { ":" },
+        brain_dir.display()
+    );
+
+    // Find python
+    let python = if cfg!(windows) { "python" } else { "python3" };
+
+    match Command::new(python)
+        .args(["-m", "jarvis_brain.demo_server"])
+        .env("PYTHONPATH", &pythonpath)
+        .current_dir(&brain_dir)
+        .stdout(std::process::Stdio::null())
+        .stderr(std::process::Stdio::null())
+        .spawn()
+    {
+        Ok(child) => {
+            eprintln!("[Orb] Brain started (PID: {})", child.id());
+            // Don't wait — let it run as background process
+            // It will be killed when Orb exits (child process)
+            std::mem::forget(child);
+        }
+        Err(e) => {
+            eprintln!("[Orb] Failed to start Brain: {}", e);
+        }
+    }
+}
+
 fn main() {
+    // Start Brain Lite WebSocket server before Tauri
+    start_brain();
+
     tauri::Builder::default()
         .run(tauri::generate_context!())
         .expect("error while running Jarvis Orb");