gitnexus-mcp 0.1.0

package/dist/commands/daemon.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"daemon.d.ts","sourceRoot":"","sources":["../../src/commands/daemon.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAeH;;GAEG;AACH,UAAU,eAAe;IACvB,WAAW,EAAE,MAAM,CAAC;IACpB,KAAK,EAAE;QACL,SAAS,EAAE,MAAM,CAAC;QAClB,aAAa,EAAE,MAAM,CAAC;QACtB,UAAU,EAAE,MAAM,CAAC;QACnB,cAAc,EAAE,MAAM,CAAC;QACvB,WAAW,EAAE,MAAM,CAAC;KACrB,CAAC;IACF,QAAQ,EAAE,KAAK,CAAC;QACd,IAAI,EAAE,MAAM,CAAC;QACb,IAAI,EAAE,MAAM,CAAC;QACb,QAAQ,EAAE,MAAM,CAAC;QACjB,WAAW,EAAE,MAAM,CAAC;KACrB,CAAC,CAAC;IACH,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,UAAU,aAAa;IACrB,IAAI,EAAE,MAAM,CAAC;CACd;AAKD,wBAAgB,kBAAkB,IAAI,eAAe,GAAG,IAAI,CAE3D;AAED,wBAAsB,aAAa,CAAC,OAAO,EAAE,aAAa,iBAsLzD"}

package/dist/commands/daemon.js

@@ -0,0 +1,173 @@
+/**
+ * Daemon Command
+ *
+ * Runs a persistent daemon that acts as the central hub for:
+ * - Browser connections (GitNexus web app)
+ * - MCP server connections (from AI tools like Cursor, Antigravity)
+ *
+ * This allows multiple AI tools to share the same browser bridge.
+ * Also stores codebase context sent by the browser for MCP resource exposure.
+ */
+import { WebSocketServer, WebSocket } from 'ws';
+// Module-level state for context (so MCP servers can access it)
+let currentContext = null;
+export function getCodebaseContext() {
+    return currentContext;
+}
+export async function daemonCommand(options) {
+    const port = parseInt(options.port, 10);
+    let browserClient = null;
+    const mcpClients = new Set();
+    const pendingRequests = new Map(); // request ID → which MCP client sent it
+    const agentSessions = new Map();
+    const agentInstanceCounters = new Map(); // agentType → next instance number
+    const wss = new WebSocketServer({ port });
+    console.log(`🔌 GitNexus MCP Daemon running on port ${port}`);
+    console.log('   Waiting for connections...\n');
+    wss.on('connection', (ws, req) => {
+        // Determine client type from URL path
+        const url = new URL(req.url || '/', `http://localhost:${port}`);
+        const clientType = url.pathname === '/mcp' ? 'mcp' : 'browser';
+        if (clientType === 'browser') {
+            // Browser connection
+            if (browserClient) {
+                browserClient.close();
+            }
+            browserClient = ws;
+            console.log('✅ Browser connected');
+            ws.on('message', (data) => {
+                try {
+                    const msg = JSON.parse(data.toString());
+                    // Handle context update from browser
+                    if (msg.type === 'context' && msg.params) {
+                        currentContext = msg.params;
+                        console.log(`📊 Context received: ${currentContext.projectName} (${currentContext.stats.fileCount} files)`);
+                        // Broadcast context update to all MCP clients
+                        const contextNotification = JSON.stringify({
+                            type: 'context_update',
+                            context: currentContext,
+                        });
+                        mcpClients.forEach(client => {
+                            if (client.readyState === WebSocket.OPEN) {
+                                client.send(contextNotification);
+                            }
+                        });
+                        return;
+                    }
+                    // Response from browser - route back to the MCP client that sent the request
+                    if (msg.id && pendingRequests.has(msg.id)) {
+                        const mcpClient = pendingRequests.get(msg.id);
+                        pendingRequests.delete(msg.id);
+                        if (mcpClient.readyState === WebSocket.OPEN) {
+                            mcpClient.send(JSON.stringify(msg));
+                        }
+                    }
+                }
+                catch (error) {
+                    console.error('Failed to parse browser message:', error);
+                }
+            });
+            ws.on('close', () => {
+                if (browserClient === ws) {
+                    browserClient = null;
+                    currentContext = null; // Clear context when browser disconnects
+                    console.log('❌ Browser disconnected');
+                }
+            });
+        }
+        else {
+            // MCP server connection
+            mcpClients.add(ws);
+            console.log(`✅ MCP client connected (total: ${mcpClients.size})`);
+            // Send current context to new MCP client if available
+            if (currentContext) {
+                ws.send(JSON.stringify({
+                    type: 'context_update',
+                    context: currentContext,
+                }));
+            }
+            ws.on('message', (data) => {
+                try {
+                    const msg = JSON.parse(data.toString());
+                    // Handle context request
+                    if (msg.method === 'getContext') {
+                        ws.send(JSON.stringify({
+                            id: msg.id,
+                            result: currentContext,
+                        }));
+                        return;
+                    }
+                    // Tool call request from MCP server - forward to browser
+                    if (msg.method && msg.id) {
+                        // Handle session tracking
+                        let session = agentSessions.get(ws);
+                        const rawAgentName = msg.agentName || 'Unknown';
+                        if (!session) {
+                            // First time seeing this connection - assign instance ID
+                            const currentCount = agentInstanceCounters.get(rawAgentName) || 0;
+                            const newCount = currentCount + 1;
+                            agentInstanceCounters.set(rawAgentName, newCount);
+                            session = {
+                                agentType: rawAgentName,
+                                instanceId: newCount,
+                                sessionId: `sess_${Date.now()}_${Math.random().toString(36).substr(2, 9)}`
+                            };
+                            agentSessions.set(ws, session);
+                            console.log(`🆕 Registered ${rawAgentName} #${newCount}`);
+                            // Notify browser about new agent (optional, mainly for UI updates if needed later)
+                            // browserClient?.send(JSON.stringify({ type: 'agent_info', ... }));
+                        }
+                        // Construct display name (e.g., "Claude #1")
+                        // If it's the first instance, maybe just keep "Claude" or do we always want numbers?
+                        // User asked for tracking multiple, so "Claude #1" is clearer even for the first if we expect multiples.
+                        // Let's use format "Name #N"
+                        const uniqueAgentName = `${session.agentType} #${session.instanceId}`;
+                        if (browserClient && browserClient.readyState === WebSocket.OPEN) {
+                            pendingRequests.set(msg.id, ws);
+                            // Forward with unique name
+                            const forwardMsg = { ...msg, agentName: uniqueAgentName };
+                            browserClient.send(JSON.stringify(forwardMsg));
+                        }
+                        else {
+                            // No browser connected
+                            ws.send(JSON.stringify({
+                                id: msg.id,
+                                error: { message: 'GitNexus browser not connected. Open GitNexus and enable MCP toggle.' }
+                            }));
+                        }
+                    }
+                }
+                catch (error) {
+                    console.error('Failed to parse MCP message:', error);
+                }
+            });
+            ws.on('close', () => {
+                const session = agentSessions.get(ws);
+                if (session) {
+                    console.log(`❌ ${session.agentType} #${session.instanceId} disconnected`);
+                    agentSessions.delete(ws);
+                }
+                mcpClients.delete(ws);
+                console.log(`Remaining clients: ${mcpClients.size}`);
+            });
+        }
+        ws.on('error', (error) => {
+            console.error('WebSocket error:', error.message);
+        });
+    });
+    wss.on('error', (error) => {
+        if (error.code === 'EADDRINUSE') {
+            console.error(`❌ Port ${port} is already in use.`);
+            console.error('   A daemon may already be running. Check with: lsof -i :54319');
+            process.exit(1);
+        }
+        console.error('Server error:', error);
+    });
+    // Keep the daemon running
+    process.on('SIGINT', () => {
+        console.log('\n👋 Shutting down daemon...');
+        wss.close();
+        process.exit(0);
+    });
+}
+//# sourceMappingURL=daemon.js.map

package/dist/commands/daemon.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"daemon.js","sourceRoot":"","sources":["../../src/commands/daemon.ts"],"names":[],"mappings":"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"}

package/dist/commands/generate-guidance.d.ts

@@ -0,0 +1,13 @@
+/**
+ * Generate Guidance Command
+ *
+ * Creates AI assistant guidance files for a project:
+ * - .cursor/rules/gitnexus.mdc - Cursor skills file
+ * - AGENTS.md - Generic tool usage patterns for Claude Code etc.
+ */
+interface GenerateOptions {
+    output: string;
+}
+export declare function generateGuidanceCommand(options: GenerateOptions): Promise<void>;
+export {};
+//# sourceMappingURL=generate-guidance.d.ts.map

package/dist/commands/generate-guidance.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"generate-guidance.d.ts","sourceRoot":"","sources":["../../src/commands/generate-guidance.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAOH,UAAU,eAAe;IACvB,MAAM,EAAE,MAAM,CAAC;CAChB;AA0GD,wBAAsB,uBAAuB,CAAC,OAAO,EAAE,eAAe,GAAG,OAAO,CAAC,IAAI,CAAC,CA8BrF"}

package/dist/commands/generate-guidance.js

@@ -0,0 +1,140 @@
+/**
+ * Generate Guidance Command
+ *
+ * Creates AI assistant guidance files for a project:
+ * - .cursor/rules/gitnexus.mdc - Cursor skills file
+ * - AGENTS.md - Generic tool usage patterns for Claude Code etc.
+ */
+import { writeFile, mkdir } from 'fs/promises';
+import { existsSync } from 'fs';
+import { join } from 'path';
+import chalk from 'chalk';
+// Cursor uses MDC format (Markdown with frontmatter)
+const CURSOR_RULES_CONTENT = `---
+description: GitNexus MCP code intelligence tools
+globs:
+alwaysApply: true
+---
+
+# GitNexus Code Intelligence
+
+This project uses GitNexus MCP for code understanding. You have access to these tools:
+
+## Available MCP Tools
+
+### search
+Semantic search across code. Returns functions, classes, files matching meaning.
+- Use for: Finding code by description, not exact text
+- Example: "authentication logic", "database connection handling"
+
+### cypher
+Direct KuzuDB graph queries for relationship traversal.
+- Pattern: \`MATCH (f:Function)-[:CodeRelation {type:'CALLS'}]->(g:Function) RETURN f.name, g.name\`
+- Node types: File, Folder, Function, Class, Interface, Method, CodeElement
+- Relation types: CONTAINS, DEFINES, IMPORTS, CALLS, EXTENDS, IMPLEMENTS
+
+### blastRadius
+Find all code affected by changing a node. Returns N-hop connections.
+- Use for: Before refactoring, understanding impact of changes
+
+### highlight
+Highlight nodes in the graph visualization.
+
+### context
+Get project overview: stats, hotspots, folder tree.
+- Use for: Understanding project structure
+
+### grep
+Regex pattern search across file contents.
+- Use for: Finding exact patterns, TODOs
+
+### read
+Read file content by path. Supports line ranges.
+
+## Best Practices
+
+1. **Start with context** - Understand project structure first
+2. **Use search for discovery** - Find by meaning, not keywords
+3. **Use cypher for relationships** - Call chains, imports, inheritance
+4. **Check blast radius before refactoring** - Understand impact
+
+## Cypher Examples
+
+\`\`\`cypher
+# Find functions that call a specific function
+MATCH (caller:Function)-[:CodeRelation {type:'CALLS'}]->(target:Function {name: 'authenticate'})
+RETURN caller.name, caller.filePath
+
+# Find class inheritance
+MATCH (child:Class)-[:CodeRelation {type:'EXTENDS'}]->(parent:Class)
+RETURN child.name, parent.name
+\`\`\`
+`;
+const AGENTS_MD_CONTENT = `# GitNexus Agent Guidelines
+
+This document describes how to use GitNexus MCP tools for code understanding.
+
+## Quick Reference
+
+| Tool | Use When | Example |
+|------|----------|---------|
+| \`search\` | Finding code by meaning | "user authentication flow" |
+| \`cypher\` | Traversing relationships | Finding what calls a function |
+| \`blastRadius\` | Before refactoring | What depends on this class? |
+| \`context\` | Understanding project | Get overview, hotspots |
+| \`grep\` | Exact pattern match | Find all TODO comments |
+| \`read\` | Reading file content | View actual code |
+| \`highlight\` | Visual feedback | Show user what you found |
+
+## Node Types
+File, Folder, Function, Class, Interface, Method, CodeElement
+
+## Relation Types
+CONTAINS, DEFINES, IMPORTS, CALLS, EXTENDS, IMPLEMENTS
+
+## Cypher Query Examples
+
+\`\`\`cypher
+-- Find functions called by a specific function
+MATCH (f:Function {name: 'handleRequest'})-[:CodeRelation {type:'CALLS'}]->(called)
+RETURN called.name, called.filePath
+
+-- Find class hierarchy
+MATCH (c:Class)-[:CodeRelation {type:'EXTENDS'}*1..3]->(parent)
+RETURN c.name, collect(parent.name) as ancestors
+\`\`\`
+
+## Workflow
+
+1. Run \`context\` to understand project structure
+2. Use \`search\` to find relevant code
+3. Use \`blastRadius\` before making changes
+4. Use \`read\` to examine actual code
+`;
+export async function generateGuidanceCommand(options) {
+    const outputDir = options.output || '.';
+    console.log(chalk.cyan('\n🔧 Generating AI agent guidance files...\n'));
+    try {
+        // Create .cursor/rules directory
+        const cursorRulesDir = join(outputDir, '.cursor', 'rules');
+        if (!existsSync(cursorRulesDir)) {
+            await mkdir(cursorRulesDir, { recursive: true });
+        }
+        // Write .cursor/rules/gitnexus.mdc
+        const cursorRulePath = join(cursorRulesDir, 'gitnexus.mdc');
+        await writeFile(cursorRulePath, CURSOR_RULES_CONTENT, 'utf-8');
+        console.log(chalk.green('✓'), 'Created', chalk.bold('.cursor/rules/gitnexus.mdc'));
+        // Write AGENTS.md
+        const agentsPath = join(outputDir, 'AGENTS.md');
+        await writeFile(agentsPath, AGENTS_MD_CONTENT, 'utf-8');
+        console.log(chalk.green('✓'), 'Created', chalk.bold('AGENTS.md'));
+        console.log(chalk.green('\n✅ Guidance files generated successfully!'));
+        console.log(chalk.dim('\nThese files help AI assistants understand how to use GitNexus MCP tools.'));
+        console.log(chalk.dim('Commit them to your repo so all team members benefit.\n'));
+    }
+    catch (error) {
+        console.error(chalk.red('\n❌ Error generating guidance files:'), error);
+        process.exit(1);
+    }
+}
+//# sourceMappingURL=generate-guidance.js.map

package/dist/commands/generate-guidance.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"generate-guidance.js","sourceRoot":"","sources":["../../src/commands/generate-guidance.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,SAAS,EAAE,KAAK,EAAE,MAAM,aAAa,CAAC;AAC/C,OAAO,EAAE,UAAU,EAAE,MAAM,IAAI,CAAC;AAChC,OAAO,EAAE,IAAI,EAAE,MAAM,MAAM,CAAC;AAC5B,OAAO,KAAK,MAAM,OAAO,CAAC;AAM1B,qDAAqD;AACrD,MAAM,oBAAoB,GAAG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CA2D5B,CAAC;AAEF,MAAM,iBAAiB,GAAG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAwCzB,CAAC;AAEF,MAAM,CAAC,KAAK,UAAU,uBAAuB,CAAC,OAAwB;IACpE,MAAM,SAAS,GAAG,OAAO,CAAC,MAAM,IAAI,GAAG,CAAC;IAExC,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,8CAA8C,CAAC,CAAC,CAAC;IAExE,IAAI,CAAC;QACH,iCAAiC;QACjC,MAAM,cAAc,GAAG,IAAI,CAAC,SAAS,EAAE,SAAS,EAAE,OAAO,CAAC,CAAC;QAC3D,IAAI,CAAC,UAAU,CAAC,cAAc,CAAC,EAAE,CAAC;YAChC,MAAM,KAAK,CAAC,cAAc,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;QACnD,CAAC;QAED,mCAAmC;QACnC,MAAM,cAAc,GAAG,IAAI,CAAC,cAAc,EAAE,cAAc,CAAC,CAAC;QAC5D,MAAM,SAAS,CAAC,cAAc,EAAE,oBAAoB,EAAE,OAAO,CAAC,CAAC;QAC/D,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,KAAK,CAAC,GAAG,CAAC,EAAE,SAAS,EAAE,KAAK,CAAC,IAAI,CAAC,4BAA4B,CAAC,CAAC,CAAC;QAEnF,kBAAkB;QAClB,MAAM,UAAU,GAAG,IAAI,CAAC,SAAS,EAAE,WAAW,CAAC,CAAC;QAChD,MAAM,SAAS,CAAC,UAAU,EAAE,iBAAiB,EAAE,OAAO,CAAC,CAAC;QACxD,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,KAAK,CAAC,GAAG,CAAC,EAAE,SAAS,EAAE,KAAK,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC,CAAC;QAElE,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,KAAK,CAAC,4CAA4C,CAAC,CAAC,CAAC;QACvE,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC,4EAA4E,CAAC,CAAC,CAAC;QACrG,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC,yDAAyD,CAAC,CAAC,CAAC;IAEpF,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,OAAO,CAAC,KAAK,CAAC,KAAK,CAAC,GAAG,CAAC,sCAAsC,CAAC,EAAE,KAAK,CAAC,CAAC;QACxE,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC;AACH,CAAC"}

package/dist/commands/serve.d.ts

@@ -0,0 +1,13 @@
+/**
+ * Serve Command
+ *
+ * Starts the MCP server that bridges external AI agents to GitNexus.
+ * - Listens on stdio for MCP protocol (from AI tools)
+ * - Hosts a local WebSocket bridge for the GitNexus browser app
+ */
+interface ServeOptions {
+    port: string;
+}
+export declare function serveCommand(options: ServeOptions): Promise<void>;
+export {};
+//# sourceMappingURL=serve.d.ts.map

package/dist/commands/serve.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"serve.d.ts","sourceRoot":"","sources":["../../src/commands/serve.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAKH,UAAU,YAAY;IACpB,IAAI,EAAE,MAAM,CAAC;CACd;AAED,wBAAsB,YAAY,CAAC,OAAO,EAAE,YAAY,iBAevD"}

package/dist/commands/serve.js

@@ -0,0 +1,23 @@
+/**
+ * Serve Command
+ *
+ * Starts the MCP server that bridges external AI agents to GitNexus.
+ * - Listens on stdio for MCP protocol (from AI tools)
+ * - Hosts a local WebSocket bridge for the GitNexus browser app
+ */
+import { startMCPServer } from '../mcp/server.js';
+import { WebSocketBridge } from '../bridge/websocket-server.js';
+export async function serveCommand(options) {
+    const port = parseInt(options.port, 10);
+    // Start local WebSocket bridge (browser connects to ws://localhost:<port>)
+    const client = new WebSocketBridge(port);
+    const started = await client.start();
+    if (!started) {
+        console.error(`Failed to start GitNexus browser bridge on port ${port}.`);
+        console.error('Another process is already using this port.');
+        process.exit(1);
+    }
+    // Start MCP server on stdio (AI tools connect here)
+    await startMCPServer(client);
+}
+//# sourceMappingURL=serve.js.map

package/dist/commands/serve.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"serve.js","sourceRoot":"","sources":["../../src/commands/serve.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAClD,OAAO,EAAE,eAAe,EAAE,MAAM,+BAA+B,CAAC;AAMhE,MAAM,CAAC,KAAK,UAAU,YAAY,CAAC,OAAqB;IACtD,MAAM,IAAI,GAAG,QAAQ,CAAC,OAAO,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC;IAExC,2EAA2E;IAC3E,MAAM,MAAM,GAAG,IAAI,eAAe,CAAC,IAAI,CAAC,CAAC;IACzC,MAAM,OAAO,GAAG,MAAM,MAAM,CAAC,KAAK,EAAE,CAAC;IAErC,IAAI,CAAC,OAAO,EAAE,CAAC;QACb,OAAO,CAAC,KAAK,CAAC,mDAAmD,IAAI,GAAG,CAAC,CAAC;QAC1E,OAAO,CAAC,KAAK,CAAC,6CAA6C,CAAC,CAAC;QAC7D,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC;IAED,oDAAoD;IACpD,MAAM,cAAc,CAAC,MAAM,CAAC,CAAC;AAC/B,CAAC"}

package/dist/commands/setup.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Setup Command
+ *
+ * Detects installed AI tools (Cursor, Claude Code, Windsurf) and
+ * configures their MCP settings to use GitNexus.
+ */
+export declare function setupCommand(): Promise<void>;
+//# sourceMappingURL=setup.d.ts.map

package/dist/commands/setup.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"setup.d.ts","sourceRoot":"","sources":["../../src/commands/setup.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAQH,wBAAsB,YAAY,kBAyCjC"}

package/dist/commands/setup.js

@@ -0,0 +1,48 @@
+/**
+ * Setup Command
+ *
+ * Detects installed AI tools (Cursor, Claude Code, Windsurf) and
+ * configures their MCP settings to use GitNexus.
+ */
+import chalk from 'chalk';
+import ora from 'ora';
+import { detectIDEs } from '../config/detect-ides.js';
+import { injectMCPConfig } from '../config/inject-config.js';
+import { getBridgePath } from '../config/paths.js';
+export async function setupCommand() {
+    console.log(chalk.blue('\n🔧 GitNexus MCP Setup\n'));
+    // Step 1: Get bridge path (this CLI itself is the bridge)
+    const spinner = ora('Locating bridge...').start();
+    const bridgePath = getBridgePath();
+    spinner.succeed(`Bridge located at ${chalk.dim(bridgePath)}`);
+    // Step 2: Detect AI tools
+    spinner.start('Detecting AI tools...');
+    const ides = await detectIDEs();
+    if (ides.length === 0) {
+        spinner.warn('No supported AI tools detected');
+        console.log(chalk.yellow('\nSupported tools: Cursor, Claude Code, Windsurf, VS Code'));
+        console.log('Install one of these tools to use GitNexus MCP.\n');
+        return;
+    }
+    spinner.succeed(`Found: ${ides.map(i => chalk.cyan(i.name)).join(', ')}`);
+    // Step 3: Inject MCP config into each IDE
+    for (const ide of ides) {
+        spinner.start(`Configuring ${ide.name}...`);
+        try {
+            await injectMCPConfig(ide, bridgePath);
+            spinner.succeed(`Configured ${chalk.cyan(ide.name)}`);
+        }
+        catch (error) {
+            spinner.fail(`Failed to configure ${ide.name}: ${error}`);
+        }
+    }
+    // Success message
+    console.log(chalk.green('\n✅ Setup complete!\n'));
+    console.log('Next steps:');
+    console.log('  1. Open GitNexus in your browser');
+    console.log('  2. Load a codebase');
+    console.log('  3. Click the MCP toggle to connect');
+    console.log('  4. Your AI tools can now use GitNexus!\n');
+    console.log(chalk.dim('Available tools: search, cypher, blastRadius, highlight\n'));
+}
+//# sourceMappingURL=setup.js.map

package/dist/commands/setup.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"setup.js","sourceRoot":"","sources":["../../src/commands/setup.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,MAAM,OAAO,CAAC;AAC1B,OAAO,GAAG,MAAM,KAAK,CAAC;AACtB,OAAO,EAAE,UAAU,EAAY,MAAM,0BAA0B,CAAC;AAChE,OAAO,EAAE,eAAe,EAAE,MAAM,4BAA4B,CAAC;AAC7D,OAAO,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AAEnD,MAAM,CAAC,KAAK,UAAU,YAAY;IAChC,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,2BAA2B,CAAC,CAAC,CAAC;IAErD,0DAA0D;IAC1D,MAAM,OAAO,GAAG,GAAG,CAAC,oBAAoB,CAAC,CAAC,KAAK,EAAE,CAAC;IAClD,MAAM,UAAU,GAAG,aAAa,EAAE,CAAC;IACnC,OAAO,CAAC,OAAO,CAAC,qBAAqB,KAAK,CAAC,GAAG,CAAC,UAAU,CAAC,EAAE,CAAC,CAAC;IAE9D,0BAA0B;IAC1B,OAAO,CAAC,KAAK,CAAC,uBAAuB,CAAC,CAAC;IACvC,MAAM,IAAI,GAAG,MAAM,UAAU,EAAE,CAAC;IAEhC,IAAI,IAAI,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACtB,OAAO,CAAC,IAAI,CAAC,gCAAgC,CAAC,CAAC;QAC/C,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,MAAM,CAAC,2DAA2D,CAAC,CAAC,CAAC;QACvF,OAAO,CAAC,GAAG,CAAC,mDAAmD,CAAC,CAAC;QACjE,OAAO;IACT,CAAC;IAED,OAAO,CAAC,OAAO,CAAC,UAAU,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IAE1E,0CAA0C;IAC1C,KAAK,MAAM,GAAG,IAAI,IAAI,EAAE,CAAC;QACvB,OAAO,CAAC,KAAK,CAAC,eAAe,GAAG,CAAC,IAAI,KAAK,CAAC,CAAC;QAC5C,IAAI,CAAC;YACH,MAAM,eAAe,CAAC,GAAG,EAAE,UAAU,CAAC,CAAC;YACvC,OAAO,CAAC,OAAO,CAAC,cAAc,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QACxD,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,OAAO,CAAC,IAAI,CAAC,uBAAuB,GAAG,CAAC,IAAI,KAAK,KAAK,EAAE,CAAC,CAAC;QAC5D,CAAC;IACH,CAAC;IAED,kBAAkB;IAClB,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,KAAK,CAAC,uBAAuB,CAAC,CAAC,CAAC;IAClD,OAAO,CAAC,GAAG,CAAC,aAAa,CAAC,CAAC;IAC3B,OAAO,CAAC,GAAG,CAAC,oCAAoC,CAAC,CAAC;IAClD,OAAO,CAAC,GAAG,CAAC,sBAAsB,CAAC,CAAC;IACpC,OAAO,CAAC,GAAG,CAAC,sCAAsC,CAAC,CAAC;IACpD,OAAO,CAAC,GAAG,CAAC,4CAA4C,CAAC,CAAC;IAE1D,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC,2DAA2D,CAAC,CAAC,CAAC;AACtF,CAAC"}

package/dist/config/detect-ides.d.ts

@@ -0,0 +1,12 @@
+/**
+ * IDE Detection
+ *
+ * Detects installed AI coding tools by checking for their config directories.
+ * Supports Windows, macOS, and Linux paths.
+ */
+export interface IDE {
+    name: string;
+    configPath: string;
+}
+export declare function detectIDEs(): Promise<IDE[]>;
+//# sourceMappingURL=detect-ides.d.ts.map

package/dist/config/detect-ides.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"detect-ides.d.ts","sourceRoot":"","sources":["../../src/config/detect-ides.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAMH,MAAM,WAAW,GAAG;IAClB,IAAI,EAAE,MAAM,CAAC;IACb,UAAU,EAAE,MAAM,CAAC;CACpB;AA+DD,wBAAsB,UAAU,IAAI,OAAO,CAAC,GAAG,EAAE,CAAC,CAyBjD"}

package/dist/config/detect-ides.js

@@ -0,0 +1,81 @@
+/**
+ * IDE Detection
+ *
+ * Detects installed AI coding tools by checking for their config directories.
+ * Supports Windows, macOS, and Linux paths.
+ */
+import { existsSync } from 'fs';
+import { homedir, platform } from 'os';
+import { join } from 'path';
+const IDE_CHECKS = [
+    {
+        name: 'Cursor',
+        paths: {
+            win32: ['AppData/Roaming/Cursor/User/globalStorage/mcp.json', '.cursor/mcp.json'],
+            darwin: ['.cursor/mcp.json', 'Library/Application Support/Cursor/User/globalStorage/mcp.json'],
+            linux: ['.cursor/mcp.json', '.config/Cursor/User/globalStorage/mcp.json'],
+        },
+    },
+    {
+        name: 'Claude Code',
+        paths: {
+            win32: ['.claude/mcp.json', 'AppData/Roaming/Claude/mcp.json'],
+            darwin: ['.claude/mcp.json', 'Library/Application Support/Claude/mcp.json'],
+            linux: ['.claude/mcp.json', '.config/Claude/mcp.json'],
+        },
+    },
+    {
+        name: 'Windsurf',
+        paths: {
+            win32: ['.windsurf/mcp.json', '.codeium/windsurf/mcp.json'],
+            darwin: ['.windsurf/mcp.json', '.codeium/windsurf/mcp.json'],
+            linux: ['.windsurf/mcp.json', '.codeium/windsurf/mcp.json'],
+        },
+    },
+    {
+        name: 'VS Code',
+        paths: {
+            win32: ['AppData/Roaming/Code/User/globalStorage/mcp.json'],
+            darwin: ['Library/Application Support/Code/User/globalStorage/mcp.json'],
+            linux: ['.config/Code/User/globalStorage/mcp.json'],
+        },
+    },
+    {
+        name: 'Antigravity',
+        paths: {
+            win32: ['.gemini/antigravity/mcp_config.json'],
+            darwin: ['.gemini/antigravity/mcp_config.json'],
+            linux: ['.gemini/antigravity/mcp_config.json'],
+        },
+    },
+    {
+        name: 'OpenCode',
+        paths: {
+            win32: ['.config/opencode/opencode.json', 'opencode.json'],
+            darwin: ['.config/opencode/opencode.json', 'opencode.json'],
+            linux: ['.config/opencode/opencode.json', 'opencode.json'],
+        },
+    },
+];
+export async function detectIDEs() {
+    const home = homedir();
+    const os = platform();
+    const ides = [];
+    for (const check of IDE_CHECKS) {
+        const paths = check.paths[os] || check.paths.linux;
+        for (const relPath of paths) {
+            const configPath = join(home, relPath);
+            // Check if the parent directory exists (IDE is installed)
+            const dirPath = configPath.replace(/[/\\]mcp\.json$/, '');
+            const parentDir = dirPath.split(/[/\\]/).slice(0, -1).join('/');
+            // Look for IDE installation markers
+            const ideDirExists = existsSync(dirPath) || existsSync(parentDir);
+            if (ideDirExists) {
+                ides.push({ name: check.name, configPath });
+                break; // Found this IDE, move to next
+            }
+        }
+    }
+    return ides;
+}
+//# sourceMappingURL=detect-ides.js.map

package/dist/config/detect-ides.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"detect-ides.js","sourceRoot":"","sources":["../../src/config/detect-ides.ts"],"names":[],"mappings":"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"}

package/dist/config/inject-config.d.ts

@@ -0,0 +1,9 @@
+/**
+ * MCP Config Injection
+ *
+ * Adds GitNexus MCP server to an IDE's configuration.
+ * Handles different config formats for different tools.
+ */
+import { type IDE } from './detect-ides.js';
+export declare function injectMCPConfig(ide: IDE, bridgePath: string): Promise<void>;
+//# sourceMappingURL=inject-config.d.ts.map

package/dist/config/inject-config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"inject-config.d.ts","sourceRoot":"","sources":["../../src/config/inject-config.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAIH,OAAO,EAAE,KAAK,GAAG,EAAE,MAAM,kBAAkB,CAAC;AAsB5C,wBAAsB,eAAe,CAAC,GAAG,EAAE,GAAG,EAAE,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAqCjF"}

package/dist/config/inject-config.js

@@ -0,0 +1,65 @@
+/**
+ * MCP Config Injection
+ *
+ * Adds GitNexus MCP server to an IDE's configuration.
+ * Handles different config formats for different tools.
+ */
+import { readFileSync, writeFileSync, mkdirSync, existsSync } from 'fs';
+import { dirname } from 'path';
+export async function injectMCPConfig(ide, bridgePath) {
+    // Create directory structure if needed
+    if (!existsSync(ide.configPath)) {
+        const dir = dirname(ide.configPath);
+        mkdirSync(dir, { recursive: true });
+    }
+    // Handle OpenCode's different format
+    if (ide.name === 'OpenCode') {
+        await injectOpenCodeConfig(ide.configPath, bridgePath);
+        return;
+    }
+    // Standard MCP format (Cursor, Claude Code, Windsurf, VS Code, Antigravity)
+    let config = { mcpServers: {} };
+    // Read existing config if present
+    if (existsSync(ide.configPath)) {
+        try {
+            const content = readFileSync(ide.configPath, 'utf-8');
+            config = JSON.parse(content);
+        }
+        catch {
+            // Ignore parse errors, use empty config
+        }
+    }
+    // Ensure mcpServers object exists
+    config.mcpServers = config.mcpServers || {};
+    // Add GitNexus MCP server configuration
+    config.mcpServers.gitnexus = {
+        command: bridgePath,
+        args: ['serve'],
+    };
+    // Write updated config
+    writeFileSync(ide.configPath, JSON.stringify(config, null, 2));
+}
+async function injectOpenCodeConfig(configPath, bridgePath) {
+    let config = {};
+    // Read existing config if present
+    if (existsSync(configPath)) {
+        try {
+            const content = readFileSync(configPath, 'utf-8');
+            config = JSON.parse(content);
+        }
+        catch {
+            // Ignore parse errors
+        }
+    }
+    // Ensure mcp object exists
+    config.mcp = config.mcp || {};
+    // Add GitNexus MCP server (OpenCode format)
+    config.mcp.gitnexus = {
+        type: 'local',
+        command: bridgePath,
+        args: ['serve'],
+    };
+    // Write updated config
+    writeFileSync(configPath, JSON.stringify(config, null, 2));
+}
+//# sourceMappingURL=inject-config.js.map