@vibescope/mcp-server 0.3.4 → 0.3.6

package/dist/cli-init.js

@@ -173,24 +173,23 @@ function detectAgents() {
 // Agent Configurators
 // ============================================================================
 async function configureClaudeCode(apiKey) {
-    // Try using `claude mcp add` command
-    try {
-        execSync('claude --version', { stdio: 'pipe', timeout: 5000 });
-        // Use project scope for claude mcp add
-        try {
-            execSync(`claude mcp add vibescope -e VIBESCOPE_API_KEY=${apiKey} -- npx -y -p @vibescope/mcp-server@latest vibescope-mcp`, { stdio: 'pipe', timeout: 15000 });
-            console.log(`  ${icon.check} Claude Code configured via ${c.cyan}claude mcp add${c.reset}`);
-            return;
-        }
-        catch {
-            // claude mcp add not available (older version), fall through to manual config
-        }
-    }
-    catch { /* claude CLI not available */ }
-    // Fallback: write .mcp.json
+    // Write project-level .mcp.json (works reliably across all platforms)
     const configPath = join(process.cwd(), '.mcp.json');
     writeMcpJson(configPath, apiKey);
     console.log(`  ${icon.check} Wrote ${c.cyan}.mcp.json${c.reset} (Claude Code project config)`);
+    // Also offer to write user-level config for global access
+    const globalConfig = platform() === 'win32'
+        ? join(homedir(), '.claude', 'settings.json')
+        : join(homedir(), '.claude', 'settings.json');
+    const addGlobal = await promptConfirm(`  Also add Vibescope globally (all projects)?`, true);
+    if (addGlobal) {
+        const existing = readJsonFile(globalConfig);
+        const mcpServers = existing.mcpServers || {};
+        mcpServers['vibescope'] = buildMcpServerConfig(apiKey);
+        existing.mcpServers = mcpServers;
+        writeJsonFile(globalConfig, existing);
+        console.log(`  ${icon.check} Wrote ${c.cyan}~/.claude/settings.json${c.reset} (global config)`);
+    }
 }
 async function configureCursor(apiKey) {
     const configPath = join(process.cwd(), '.cursor', 'mcp.json');
@@ -207,9 +206,7 @@ async function configureGemini(apiKey) {
     const existing = readJsonFile(configPath);
     const mcpServers = existing.mcpServers || {};
     mcpServers['vibescope'] = {
-        command: 'npx',
-        args: ['-y', '-p', '@vibescope/mcp-server@latest', 'vibescope-mcp'],
-        env: { VIBESCOPE_API_KEY: apiKey },
+        ...buildMcpServerConfig(apiKey),
         timeout: 30000,
         trust: true,
     };
@@ -236,14 +233,25 @@ function writeJsonFile(path, data) {
     }
     writeFileSync(path, JSON.stringify(data, null, 2) + '\n');
 }
-function writeMcpJson(configPath, apiKey) {
-    const existing = readJsonFile(configPath);
-    const mcpServers = existing.mcpServers || {};
-    mcpServers['vibescope'] = {
+function buildMcpServerConfig(apiKey) {
+    const isWindows = platform() === 'win32';
+    if (isWindows) {
+        return {
+            command: 'cmd',
+            args: ['/c', 'npx', '-y', '-p', '@vibescope/mcp-server@latest', 'vibescope-mcp'],
+            env: { VIBESCOPE_API_KEY: apiKey },
+        };
+    }
+    return {
         command: 'npx',
         args: ['-y', '-p', '@vibescope/mcp-server@latest', 'vibescope-mcp'],
         env: { VIBESCOPE_API_KEY: apiKey },
     };
+}
+function writeMcpJson(configPath, apiKey) {
+    const existing = readJsonFile(configPath);
+    const mcpServers = existing.mcpServers || {};
+    mcpServers['vibescope'] = buildMcpServerConfig(apiKey);
     existing.mcpServers = mcpServers;
     writeJsonFile(configPath, existing);
 }

package/docs/TOOLS.md

@@ -2,9 +2,9 @@
 
 > Auto-generated from tool definitions. Do not edit manually.
 >
-> Generated: 2026-02-06
+> Generated: 2026-02-12
 >
-> Total tools: 154
+> Total tools: 156
 
 ## Table of Contents
 
@@ -2457,3 +2457,27 @@ Use this to check the state of cloud agents before/after cleanup.
 | `status` | `"starting" | "running" | "stopped" | "failed" | "all"` | No | Filter by status (default: all) |
 
 ---
+
+## Uncategorized
+
+*Tools not yet assigned to a category*
+
+### check_mcp_version
+
+Check if the Vibescope MCP server is up to date. Compares the locally installed version against the latest published version on npm. Call this when starting a session or when the server instructions indicate an update is available.
+
+**Parameters:** None
+
+---
+
+### update_mcp_server
+
+Update the Vibescope MCP server to the latest version. Runs npm install to fetch the latest version. After updating, the server must be restarted (the agent should ask the user to restart their MCP client/editor). Only call this when the user agrees to update.
+
+**Parameters:**
+
+| Parameter | Type | Required | Description |
+|-----------|------|----------|-------------|
+| `global` | `boolean` | No | If true, update the global installation (npm install -g). If false, update locally. Default: true. |
+
+---

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@vibescope/mcp-server",
-  "version": "0.3.4",
+  "version": "0.3.6",
   "description": "MCP server for Vibescope - AI project tracking tools",
   "type": "module",
   "main": "dist/index.js",

package/src/cli-init.ts

@@ -204,26 +204,25 @@ function detectAgents(): Agent[] {
 // ============================================================================
 
 async function configureClaudeCode(apiKey: string): Promise<void> {
-	// Try using `claude mcp add` command
-	try {
-		execSync('claude --version', { stdio: 'pipe', timeout: 5000 });
-		// Use project scope for claude mcp add
-		try {
-			execSync(
-				`claude mcp add vibescope -e VIBESCOPE_API_KEY=${apiKey} -- npx -y -p @vibescope/mcp-server@latest vibescope-mcp`,
-				{ stdio: 'pipe', timeout: 15000 }
-			);
-			console.log(`  ${icon.check} Claude Code configured via ${c.cyan}claude mcp add${c.reset}`);
-			return;
-		} catch {
-			// claude mcp add not available (older version), fall through to manual config
-		}
-	} catch { /* claude CLI not available */ }
-
-	// Fallback: write .mcp.json
+	// Write project-level .mcp.json (works reliably across all platforms)
 	const configPath = join(process.cwd(), '.mcp.json');
 	writeMcpJson(configPath, apiKey);
 	console.log(`  ${icon.check} Wrote ${c.cyan}.mcp.json${c.reset} (Claude Code project config)`);
+
+	// Also offer to write user-level config for global access
+	const globalConfig = platform() === 'win32'
+		? join(homedir(), '.claude', 'settings.json')
+		: join(homedir(), '.claude', 'settings.json');
+
+	const addGlobal = await promptConfirm(`  Also add Vibescope globally (all projects)?`, true);
+	if (addGlobal) {
+		const existing = readJsonFile(globalConfig);
+		const mcpServers = (existing.mcpServers as Record<string, unknown>) || {};
+		mcpServers['vibescope'] = buildMcpServerConfig(apiKey);
+		existing.mcpServers = mcpServers;
+		writeJsonFile(globalConfig, existing);
+		console.log(`  ${icon.check} Wrote ${c.cyan}~/.claude/settings.json${c.reset} (global config)`);
+	}
 }
 
 async function configureCursor(apiKey: string): Promise<void> {
@@ -243,9 +242,7 @@ async function configureGemini(apiKey: string): Promise<void> {
 	const existing = readJsonFile(configPath);
 	const mcpServers = (existing.mcpServers as Record<string, unknown>) || {};
 	mcpServers['vibescope'] = {
-		command: 'npx',
-		args: ['-y', '-p', '@vibescope/mcp-server@latest', 'vibescope-mcp'],
-		env: { VIBESCOPE_API_KEY: apiKey },
+		...buildMcpServerConfig(apiKey),
 		timeout: 30000,
 		trust: true,
 	};
@@ -275,14 +272,26 @@ function writeJsonFile(path: string, data: Record<string, unknown>): void {
 	writeFileSync(path, JSON.stringify(data, null, 2) + '\n');
 }
 
-function writeMcpJson(configPath: string, apiKey: string): void {
-	const existing = readJsonFile(configPath);
-	const mcpServers = (existing.mcpServers as Record<string, unknown>) || {};
-	mcpServers['vibescope'] = {
+function buildMcpServerConfig(apiKey: string): Record<string, unknown> {
+	const isWindows = platform() === 'win32';
+	if (isWindows) {
+		return {
+			command: 'cmd',
+			args: ['/c', 'npx', '-y', '-p', '@vibescope/mcp-server@latest', 'vibescope-mcp'],
+			env: { VIBESCOPE_API_KEY: apiKey },
+		};
+	}
+	return {
 		command: 'npx',
 		args: ['-y', '-p', '@vibescope/mcp-server@latest', 'vibescope-mcp'],
 		env: { VIBESCOPE_API_KEY: apiKey },
 	};
+}
+
+function writeMcpJson(configPath: string, apiKey: string): void {
+	const existing = readJsonFile(configPath);
+	const mcpServers = (existing.mcpServers as Record<string, unknown>) || {};
+	mcpServers['vibescope'] = buildMcpServerConfig(apiKey);
 	existing.mcpServers = mcpServers;
 	writeJsonFile(configPath, existing);
 }