aidex-mcp 1.6.0 → 1.7.0

package/CHANGELOG.md

@@ -2,6 +2,22 @@
 
 All notable changes to AiDex will be documented in this file.
 
+## [1.7.0] - 2026-02-01
+
+### Added
+- **Gemini CLI support**: `aidex setup` now detects and registers AiDex with Gemini CLI (`~/.gemini/settings.json`)
+- **VS Code Copilot support**: `aidex setup` now detects and registers AiDex with VS Code (`mcp.json` with `"servers"` key and `"type": "stdio"`)
+
+### Changed
+- JSON client config is now flexible: supports custom server key (`serversKey`) and extra fields (`extraFields`) per client
+- Updated README with Gemini CLI and VS Code Copilot config examples
+
+## [1.6.1] - 2026-02-01
+
+### Fixed
+- **MCP Server version**: Now reads version dynamically from package.json (was hardcoded to 1.3.0)
+- **`aidex setup` for local installs**: Detects if `aidex` is globally available; falls back to `node /full/path/index.js` when not installed globally
+
 ## [1.6.0] - 2026-02-01
 
 ### Added

package/FUTURE.md

@@ -0,0 +1,75 @@
+# AiDex - Future Ideas
+
+Ideensammlung für zukünftige Features und Erweiterungen.
+
+---
+
+## A. Projekt-Ebene (Erweiterungen für einzelne Projekte)
+
+### Datei-Abhängigkeiten (File Dependencies)
+- Import/Require-Analyse: Welche Datei importiert welche?
+- Impact-Analyse: "Wenn ich diese Datei ändere, welche anderen sind betroffen?"
+- Visualisierung als Graph im Viewer
+
+---
+
+## B. AiDex Global / Hub (v2.0) - Neue Meta-Ebene
+
+Meta-Ebene über allen AiDex-Projekten. Eine zentrale Datenbank (`~/.aidex/global.db`) die alle Projekt-Datenbanken kennt und somit das gesamte Ökosystem auf dem Rechner versteht.
+
+### 1. Projekt-Registry
+- Automatische Registrierung bei jedem `aidex_init`
+- Kennt Pfad, Name, Sprachen, Größe, letzter Zugriff
+- Weiß welche Projekte aktiv/archiviert/veraltet sind
+
+### 2. Cross-Project Suche
+- "Hab ich das schon mal gebaut?" → Sucht einen Term in ALLEN Projekten gleichzeitig
+- "Wo benutze ich WebSockets?" → Findet alle Projekte mit WebSocket-Code
+- "Hab ich mich damit schon mal beschäftigt?" → Durchsucht gesamtes Ökosystem
+
+### 3. Dependency-Graph zwischen Projekten ⭐
+- LibPyramid3D wird von DebugViewer verwendet
+- LibWebAppGpu wird von 6 Projekten referenziert
+- "Was bricht wenn ich LibX ändere?"
+- Automatische Erkennung über package.json, .csproj, Cargo.toml etc.
+
+### 4. Duplikat-Erkennung
+- Identische oder ähnliche Methoden-Signaturen über Projekte hinweg
+- "Du hast diese Utility-Funktion in 3 Projekten kopiert"
+- Vorschläge zum Zusammenführen in eine Shared-Library
+
+### 5. Technologie-Profil
+- "Du hast 12 TypeScript-Projekte, 8 C#, 3 Rust"
+- Welche Frameworks/Libraries werden wo eingesetzt?
+- Versions-Überblick: "5 Projekte nutzen React 18, 2 noch React 17"
+
+### 6. Pattern-Bibliothek
+- Häufig wiederverwendete Code-Patterns automatisch erkennen
+- "Deine typische HTTP-Client-Konfiguration sieht so aus..."
+- Best-Practices aus eigenen Projekten ableiten
+
+### 7. Skill / Wissens-Map
+- Aus Code ableiten: "Erfahrung mit: WebGL, Tree-sitter, SQLite, MCP Protocol, ..."
+- Tiefe vs. Breite: Wo viel Code, wo nur mal reingeschnuppert?
+- Nützlich für: "Kann ich das mit meinem Wissen umsetzen?"
+
+### 8. Projekt-Empfehlungen
+- "Projekt A und B haben ähnliche Lösungen - zusammenführen?"
+- "Projekt X wurde seit 8 Monaten nicht angefasst - archivieren?"
+- "Du hast 3 verschiedene Logger-Implementierungen - konsolidieren?"
+
+### Technische Skizze
+
+```
+~/.aidex/
+├── global.db          ← Zentrale Meta-DB
+└── (config, cache)
+
+Tabellen:
+- projects (path, name, languages, last_session, file_count, method_count)
+- global_index (term, project_id, file, line) ← aggregiert aus Projekt-DBs
+- dependencies (project_id, depends_on, type)
+- tags (project_id, tag)
+```
+
+Die globale DB zapft die Projekt-DBs periodisch an und baut einen aggregierten Index auf - nicht alles kopieren, aber genug für Cross-Project Queries.

package/README.md

@@ -7,7 +7,7 @@
 
 **Stop wasting 80% of your AI's context window on code searches.**
 
-AiDex is an MCP server that gives AI coding assistants instant access to your entire codebase through a persistent, pre-built index. Works with any MCP-compatible AI assistant: Claude Code, Cursor, Windsurf, Continue.dev, and more.
+AiDex is an MCP server that gives AI coding assistants instant access to your entire codebase through a persistent, pre-built index. Works with any MCP-compatible AI assistant: Claude Code, Claude Desktop, Cursor, Windsurf, Gemini CLI, VS Code Copilot, and more.
 
 <!-- TODO: Add demo GIF showing aidex_query vs grep -->
 
@@ -113,7 +113,7 @@ npm install -g aidex-mcp
 aidex setup
 ```
 
-`aidex setup` automatically detects and registers AiDex with your installed AI clients (Claude Code, Claude Desktop, Cursor, Windsurf). To unregister: `aidex unsetup`.
+`aidex setup` automatically detects and registers AiDex with your installed AI clients (Claude Code, Claude Desktop, Cursor, Windsurf, Gemini CLI, VS Code Copilot). To unregister: `aidex unsetup`.
 
 ### 2. Or register manually with your AI assistant
 
@@ -145,6 +145,29 @@ aidex setup
 
 > **Important:** The server name in your config determines the MCP tool prefix. Use `"aidex"` as shown above — this gives you tool names like `aidex_query`, `aidex_signature`, etc. Using a different name (e.g., `"codegraph"`) would change the prefix accordingly.
 
+**For Gemini CLI** (`~/.gemini/settings.json`):
+```json
+{
+  "mcpServers": {
+    "aidex": {
+      "command": "aidex"
+    }
+  }
+}
+```
+
+**For VS Code Copilot** (run `MCP: Open User Configuration` in Command Palette):
+```json
+{
+  "servers": {
+    "aidex": {
+      "type": "stdio",
+      "command": "aidex"
+    }
+  }
+}
+```
+
 **For other MCP clients**: See your client's documentation for MCP server configuration.
 
 ### 3. Make your AI actually use it

package/build/commands/setup.d.ts

@@ -1,7 +1,7 @@
 /**
  * AiDex Setup - Auto-register as MCP server in AI clients
  *
- * Supports: Claude Code (via CLI), Claude Desktop, Cursor, Windsurf
+ * Supports: Claude Code (via CLI), Claude Desktop, Cursor, Windsurf, Gemini CLI, VS Code Copilot
  * Also installs CLAUDE.md instructions for Claude Code/Desktop.
  */
 export declare function setupMcpClients(): void;

package/build/commands/setup.js

@@ -1,20 +1,30 @@
 /**
  * AiDex Setup - Auto-register as MCP server in AI clients
  *
- * Supports: Claude Code (via CLI), Claude Desktop, Cursor, Windsurf
+ * Supports: Claude Code (via CLI), Claude Desktop, Cursor, Windsurf, Gemini CLI, VS Code Copilot
  * Also installs CLAUDE.md instructions for Claude Code/Desktop.
  */
 import { existsSync, readFileSync, writeFileSync, mkdirSync } from 'fs';
-import { join, dirname } from 'path';
+import { join, dirname, resolve } from 'path';
 import { homedir, platform } from 'os';
 import { execSync } from 'child_process';
+import { fileURLToPath } from 'url';
 // ============================================================
-// MCP Server Entry (for JSON-based clients)
+// MCP Server Command Detection
 // ============================================================
-const AIDEX_MCP_ENTRY = {
-    command: 'aidex',
-    args: []
-};
+function getServerCommand() {
+    // Check if 'aidex' is available as a global command
+    try {
+        execSync(platform() === 'win32' ? 'where aidex' : 'which aidex', { stdio: 'pipe', timeout: 3000 });
+        return { command: 'aidex', args: [] };
+    }
+    catch {
+        // Not globally installed - use node with full path to index.js
+    }
+    const thisFile = fileURLToPath(import.meta.url);
+    const indexJs = resolve(dirname(thisFile), '..', 'index.js');
+    return { command: process.execPath, args: [indexJs] };
+}
 // ============================================================
 // CLAUDE.md Instructions Block
 // ============================================================
@@ -72,11 +82,13 @@ function getClients() {
     const plat = platform();
     const clients = [];
     // Claude Code - uses its own CLI for MCP management
+    const serverCmd = getServerCommand();
+    const cliAddCmd = ['claude', 'mcp', 'add', '--scope', 'user', 'aidex', '--', serverCmd.command, ...serverCmd.args];
     clients.push({
         type: 'cli',
         name: 'Claude Code',
         detectCmd: 'claude --version',
-        addCmd: ['claude', 'mcp', 'add', '--scope', 'user', 'aidex', '--', 'aidex'],
+        addCmd: cliAddCmd,
         removeCmd: ['claude', 'mcp', 'remove', '--scope', 'user', 'aidex']
     });
     // Claude Desktop - JSON config
@@ -119,6 +131,45 @@ function getClients() {
         configPath: join(home, '.codeium', 'windsurf', 'mcp_config.json'),
         detectDir: join(home, '.codeium', 'windsurf')
     });
+    // Gemini CLI - JSON config (always uses ~/.gemini/ on all platforms)
+    clients.push({
+        type: 'json',
+        name: 'Gemini CLI',
+        configPath: join(home, '.gemini', 'settings.json'),
+        detectDir: join(home, '.gemini')
+    });
+    // VS Code Copilot - JSON config (uses "servers" key + "type": "stdio")
+    if (plat === 'win32') {
+        const appData = process.env.APPDATA || join(home, 'AppData', 'Roaming');
+        clients.push({
+            type: 'json',
+            name: 'VS Code',
+            configPath: join(appData, 'Code', 'User', 'mcp.json'),
+            detectDir: join(appData, 'Code', 'User'),
+            serversKey: 'servers',
+            extraFields: { type: 'stdio' }
+        });
+    }
+    else if (plat === 'darwin') {
+        clients.push({
+            type: 'json',
+            name: 'VS Code',
+            configPath: join(home, 'Library', 'Application Support', 'Code', 'User', 'mcp.json'),
+            detectDir: join(home, 'Library', 'Application Support', 'Code', 'User'),
+            serversKey: 'servers',
+            extraFields: { type: 'stdio' }
+        });
+    }
+    else {
+        clients.push({
+            type: 'json',
+            name: 'VS Code',
+            configPath: join(home, '.config', 'Code', 'User', 'mcp.json'),
+            detectDir: join(home, '.config', 'Code', 'User'),
+            serversKey: 'servers',
+            extraFields: { type: 'stdio' }
+        });
+    }
     return clients;
 }
 // ============================================================
@@ -171,55 +222,63 @@ function writeJsonConfig(filePath, data) {
         return { success: false, error: String(err) };
     }
 }
-// ============================================================
-// CLAUDE.md Management
-// ============================================================
-function getClaudeMdPath() {
-    return join(homedir(), '.claude', 'CLAUDE.md');
+function getInstructionFiles() {
+    const home = homedir();
+    return [
+        {
+            name: 'CLAUDE.md',
+            path: join(home, '.claude', 'CLAUDE.md'),
+            detectDir: join(home, '.claude')
+        },
+        {
+            name: 'GEMINI.md',
+            path: join(home, '.gemini', 'GEMINI.md'),
+            detectDir: join(home, '.gemini')
+        }
+    ];
 }
-function installClaudeMd() {
-    const mdPath = getClaudeMdPath();
-    const dir = dirname(mdPath);
-    // Ensure directory exists
+function installInstructionFile(file) {
+    if (!existsSync(file.detectDir)) {
+        return { success: true, action: 'skipped (not installed)' };
+    }
+    const dir = dirname(file.path);
     if (!existsSync(dir)) {
         mkdirSync(dir, { recursive: true });
     }
     let content = '';
-    if (existsSync(mdPath)) {
-        content = readFileSync(mdPath, 'utf8');
+    if (existsSync(file.path)) {
+        content = readFileSync(file.path, 'utf8');
         // Already has AiDex block? Replace it
         if (content.includes(CLAUDE_MD_START)) {
             const regex = new RegExp(`${CLAUDE_MD_START}[\\s\\S]*?${CLAUDE_MD_END}`, 'g');
             content = content.replace(regex, CLAUDE_MD_BLOCK);
-            writeFileSync(mdPath, content, 'utf8');
+            writeFileSync(file.path, content, 'utf8');
             return { success: true, action: 'updated' };
         }
         // Append to existing file
         content = content.trimEnd() + '\n\n' + CLAUDE_MD_BLOCK + '\n';
-        writeFileSync(mdPath, content, 'utf8');
+        writeFileSync(file.path, content, 'utf8');
         return { success: true, action: 'appended' };
     }
     // Create new file
-    writeFileSync(mdPath, CLAUDE_MD_BLOCK + '\n', 'utf8');
+    writeFileSync(file.path, CLAUDE_MD_BLOCK + '\n', 'utf8');
     return { success: true, action: 'created' };
 }
-function uninstallClaudeMd() {
-    const mdPath = getClaudeMdPath();
-    if (!existsSync(mdPath)) {
+function uninstallInstructionFile(file) {
+    if (!existsSync(file.path)) {
         return { success: true, removed: false };
     }
-    let content = readFileSync(mdPath, 'utf8');
+    let content = readFileSync(file.path, 'utf8');
     if (!content.includes(CLAUDE_MD_START)) {
         return { success: true, removed: false };
     }
     const regex = new RegExp(`\\n?\\n?${CLAUDE_MD_START}[\\s\\S]*?${CLAUDE_MD_END}\\n?`, 'g');
     content = content.replace(regex, '').trim();
     if (content.length === 0) {
-        // File would be empty, but don't delete it - might have been user-created
-        writeFileSync(mdPath, '', 'utf8');
+        writeFileSync(file.path, '', 'utf8');
     }
     else {
-        writeFileSync(mdPath, content + '\n', 'utf8');
+        writeFileSync(file.path, content + '\n', 'utf8');
     }
     return { success: true, removed: true };
 }
@@ -255,10 +314,13 @@ function setupJsonClient(client) {
     else {
         data = {};
     }
-    if (!data.mcpServers || typeof data.mcpServers !== 'object') {
-        data.mcpServers = {};
+    const key = client.serversKey || 'mcpServers';
+    if (!data[key] || typeof data[key] !== 'object') {
+        data[key] = {};
     }
-    data.mcpServers.aidex = { ...AIDEX_MCP_ENTRY };
+    const serverCmd = getServerCommand();
+    const entry = { ...client.extraFields, ...serverCmd };
+    data[key].aidex = entry;
     const writeResult = writeJsonConfig(client.configPath, data);
     if (!writeResult.success) {
         return { status: `  ✗ ${client.name} (${writeResult.error})`, registered: false };
@@ -280,12 +342,16 @@ export function setupMcpClients() {
         if (result.registered)
             registered++;
     }
-    // Install CLAUDE.md instructions
+    // Install AI instruction files
     console.log('\n  AI Instructions:');
-    const mdResult = installClaudeMd();
-    const mdPath = getClaudeMdPath();
-    if (mdResult.success) {
-        console.log(`  ✓ CLAUDE.md (${mdResult.action}: ${mdPath})`);
+    for (const file of getInstructionFiles()) {
+        const mdResult = installInstructionFile(file);
+        if (mdResult.action === 'skipped (not installed)') {
+            console.log(`  - ${file.name} (client not installed)`);
+        }
+        else if (mdResult.success) {
+            console.log(`  ✓ ${file.name} (${mdResult.action}: ${file.path})`);
+        }
     }
     console.log(`\nRegistered AiDex with ${registered} client(s).\n`);
     if (registered > 0) {
@@ -319,7 +385,8 @@ function unsetupJsonClient(client) {
         return { status: `  ✗ ${client.name} (${config.error})`, removed: false };
     }
     const data = config.data;
-    const servers = data.mcpServers;
+    const key = client.serversKey || 'mcpServers';
+    const servers = data[key];
     if (!servers || !servers.aidex) {
         return { status: `  - ${client.name} (not registered)`, removed: false };
     }
@@ -345,14 +412,16 @@ export function unsetupMcpClients() {
         if (result.removed)
             removed++;
     }
-    // Remove CLAUDE.md instructions
+    // Remove AI instruction files
     console.log('\n  AI Instructions:');
-    const mdResult = uninstallClaudeMd();
-    if (mdResult.removed) {
-        console.log(`  ✓ Removed AiDex block from CLAUDE.md`);
-    }
-    else {
-        console.log(`  - CLAUDE.md (no AiDex block found)`);
+    for (const file of getInstructionFiles()) {
+        const mdResult = uninstallInstructionFile(file);
+        if (mdResult.removed) {
+            console.log(`  ✓ Removed AiDex block from ${file.name}`);
+        }
+        else {
+            console.log(`  - ${file.name} (no AiDex block found)`);
+        }
     }
     console.log(`\nUnregistered AiDex from ${removed} client(s).\n`);
 }

package/build/constants.d.ts

@@ -5,6 +5,7 @@
  */
 export declare const PRODUCT_NAME = "AiDex";
 export declare const PRODUCT_NAME_LOWER = "aidex";
+export declare const PRODUCT_VERSION: string;
 export declare const INDEX_DIR = ".aidex";
 export declare const TOOL_PREFIX = "aidex_";
 //# sourceMappingURL=constants.d.ts.map

package/build/constants.js

@@ -3,8 +3,12 @@
  *
  * Change product name here to rename the entire tool.
  */
+import { createRequire } from 'module';
+const require = createRequire(import.meta.url);
+const pkg = require('../package.json');
 export const PRODUCT_NAME = 'AiDex';
 export const PRODUCT_NAME_LOWER = 'aidex';
+export const PRODUCT_VERSION = pkg.version;
 export const INDEX_DIR = '.aidex';
 export const TOOL_PREFIX = 'aidex_';
 //# sourceMappingURL=constants.js.map

package/build/server/mcp-server.js

@@ -5,11 +5,11 @@ import { Server } from '@modelcontextprotocol/sdk/server/index.js';
 import { StdioServerTransport } from '@modelcontextprotocol/sdk/server/stdio.js';
 import { CallToolRequestSchema, ListToolsRequestSchema, } from '@modelcontextprotocol/sdk/types.js';
 import { registerTools, handleToolCall } from './tools.js';
-import { PRODUCT_NAME, PRODUCT_NAME_LOWER } from '../constants.js';
+import { PRODUCT_NAME, PRODUCT_NAME_LOWER, PRODUCT_VERSION } from '../constants.js';
 export function createServer() {
     const server = new Server({
         name: PRODUCT_NAME_LOWER,
-        version: '1.3.0',
+        version: PRODUCT_VERSION,
     }, {
         capabilities: {
             tools: {},

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "aidex-mcp",
-  "version": "1.6.0",
+  "version": "1.7.0",
   "description": "MCP Server providing persistent code indexing for Claude Code",
   "main": "build/index.js",
   "bin": {