@veewo/gitnexus 1.3.4 → 1.3.5

package/README.md

@@ -2,7 +2,7 @@
 
 **Graph-powered code intelligence for AI agents.** Index any codebase into a knowledge graph, then query it via MCP or CLI.
 
-Works with **Cursor**, **Claude Code**, **Windsurf**, **Cline**, **OpenCode**, and any MCP-compatible tool.
+Works with **Cursor**, **Claude Code**, **Codex**, **Windsurf**, **Cline**, **OpenCode**, and any MCP-compatible tool.
 
 [![npm version](https://img.shields.io/npm/v/gitnexus.svg)](https://www.npmjs.com/package/gitnexus)
 [![License: PolyForm Noncommercial](https://img.shields.io/badge/License-PolyForm%20Noncommercial-blue.svg)](https://polyformproject.org/licenses/noncommercial/1.0.0/)
@@ -43,6 +43,7 @@ Key links:
 |--------|-----|--------|---------------------|---------|
 | **Claude Code** | Yes | Yes | Yes (PreToolUse) | **Full** |
 | **Cursor** | Yes | Yes | — | MCP + Skills |
+| **Codex** | Yes | Yes | — | MCP + Skills |
 | **Windsurf** | Yes | — | — | MCP |
 | **OpenCode** | Yes | Yes | — | MCP + Skills |
 
@@ -94,6 +95,12 @@ Add to `~/.config/opencode/config.json`:
 }
 ```
 
+### Codex
+
+```bash
+codex mcp add gitnexus -- npx -y gitnexus@latest mcp
+```
+
 ## How It Works
 
 GitNexus builds a complete knowledge graph of your codebase through a multi-phase indexing pipeline:

package/dist/cli/ai-context.d.ts

@@ -2,7 +2,7 @@
  * AI Context Generator
  *
  * Creates AGENTS.md and CLAUDE.md with full inline GitNexus context.
- * AGENTS.md is the standard read by Cursor, Windsurf, OpenCode, Cline, etc.
+ * AGENTS.md is the standard read by Cursor, Windsurf, OpenCode, Codex, Cline, etc.
  * CLAUDE.md is for Claude Code which only reads that file.
  */
 interface RepoStats {

package/dist/cli/ai-context.js

@@ -2,7 +2,7 @@
  * AI Context Generator
  *
  * Creates AGENTS.md and CLAUDE.md with full inline GitNexus context.
- * AGENTS.md is the standard read by Cursor, Windsurf, OpenCode, Cline, etc.
+ * AGENTS.md is the standard read by Cursor, Windsurf, OpenCode, Codex, Cline, etc.
  * CLAUDE.md is for Claude Code which only reads that file.
  */
 import fs from 'fs/promises';
@@ -167,7 +167,7 @@ Use GitNexus tools to accomplish this task.
 export async function generateAIContextFiles(repoPath, _storagePath, projectName, stats) {
     const content = generateGitNexusContent(projectName, stats);
     const createdFiles = [];
-    // Create AGENTS.md (standard for Cursor, Windsurf, OpenCode, Cline, etc.)
+    // Create AGENTS.md (standard for Cursor, Windsurf, OpenCode, Codex, Cline, etc.)
     const agentsPath = path.join(repoPath, 'AGENTS.md');
     const agentsResult = await upsertGitNexusSection(agentsPath, content);
     createdFiles.push(`AGENTS.md (${agentsResult})`);

package/dist/cli/index.js

@@ -59,7 +59,7 @@ program
     .version(resolveCliVersion());
 program
     .command('setup')
-    .description('One-time setup: configure MCP for Cursor, Claude Code, OpenCode')
+    .description('One-time setup: configure MCP for Cursor, Claude Code, OpenCode, Codex')
     .action(setupCommand);
 program
     .command('analyze [path]')

package/dist/cli/setup.js

@@ -8,10 +8,13 @@
 import fs from 'fs/promises';
 import path from 'path';
 import os from 'os';
+import { execFile } from 'node:child_process';
+import { promisify } from 'node:util';
 import { fileURLToPath } from 'url';
 import { getGlobalDir } from '../storage/repo-manager.js';
 const __filename = fileURLToPath(import.meta.url);
 const __dirname = path.dirname(__filename);
+const execFileAsync = promisify(execFile);
 /**
  * The MCP server entry for all editors.
  * On Windows, npx must be invoked via cmd /c since it's a .cmd script.
@@ -195,6 +198,20 @@ async function setupOpenCode(result) {
         result.errors.push(`OpenCode: ${err.message}`);
     }
 }
+async function setupCodex(result) {
+    const entry = getMcpEntry();
+    try {
+        await execFileAsync('codex', ['mcp', 'add', 'gitnexus', '--', entry.command, ...entry.args], { timeout: 15000 });
+        result.configured.push('Codex');
+    }
+    catch (err) {
+        if (err?.code === 'ENOENT') {
+            result.skipped.push('Codex (not installed)');
+            return;
+        }
+        result.errors.push(`Codex: ${err.message}`);
+    }
+}
 // ─── Skill Installation ───────────────────────────────────────────
 const SKILL_NAMES = ['gitnexus-exploring', 'gitnexus-debugging', 'gitnexus-impact-analysis', 'gitnexus-refactoring', 'gitnexus-guide', 'gitnexus-cli'];
 /**
@@ -273,6 +290,7 @@ export const setupCommand = async () => {
     await setupCursor(result);
     await setupClaudeCode(result);
     await setupOpenCode(result);
+    await setupCodex(result);
     // Install shared global skills once
     await installGlobalAgentSkills(result);
     // Optional Claude-specific hooks

package/dist/cli/setup.test.js

@@ -7,11 +7,11 @@ import { execFile } from 'node:child_process';
 import { promisify } from 'node:util';
 import { fileURLToPath } from 'node:url';
 const execFileAsync = promisify(execFile);
+const here = path.dirname(fileURLToPath(import.meta.url));
+const packageRoot = path.resolve(here, '..', '..');
+const cliPath = path.join(packageRoot, 'dist', 'cli', 'index.js');
 test('setup installs global skills under ~/.agents/skills/gitnexus', async () => {
     const fakeHome = await fs.mkdtemp(path.join(os.tmpdir(), 'gitnexus-setup-home-'));
-    const here = path.dirname(fileURLToPath(import.meta.url));
-    const packageRoot = path.resolve(here, '..', '..');
-    const cliPath = path.join(packageRoot, 'dist', 'cli', 'index.js');
     try {
         await execFileAsync(process.execPath, [cliPath, 'setup'], {
             cwd: packageRoot,
@@ -29,3 +29,54 @@ test('setup installs global skills under ~/.agents/skills/gitnexus', async () =>
         await fs.rm(fakeHome, { recursive: true, force: true });
     }
 });
+test('setup configures Codex MCP when codex CLI is available', async () => {
+    const fakeHome = await fs.mkdtemp(path.join(os.tmpdir(), 'gitnexus-setup-home-'));
+    const fakeBin = await fs.mkdtemp(path.join(os.tmpdir(), 'gitnexus-setup-bin-'));
+    const codexShimPath = path.join(fakeBin, process.platform === 'win32' ? 'codex.cmd' : 'codex');
+    const shimLogic = `
+const fs = require('node:fs');
+const path = require('node:path');
+const args = process.argv.slice(2);
+if (args[0] === 'mcp' && args[1] === 'add' && args[2] === 'gitnexus') {
+  const home = process.env.HOME || process.env.USERPROFILE;
+  const outputPath = path.join(home, '.codex', 'gitnexus-mcp-add.json');
+  fs.mkdirSync(path.dirname(outputPath), { recursive: true });
+  fs.writeFileSync(outputPath, JSON.stringify({ args }, null, 2));
+  process.exit(0);
+}
+if (args[0] === '--version') {
+  process.stdout.write('codex-shim 0.0.0\\n');
+  process.exit(0);
+}
+process.exit(0);
+`;
+    try {
+        if (process.platform === 'win32') {
+            const runnerPath = path.join(fakeBin, 'codex-shim.cjs');
+            await fs.writeFile(runnerPath, shimLogic, 'utf-8');
+            await fs.writeFile(codexShimPath, `@echo off\r\nnode "${runnerPath}" %*\r\n`, 'utf-8');
+        }
+        else {
+            await fs.writeFile(codexShimPath, `#!/usr/bin/env node\n${shimLogic}`, { mode: 0o755 });
+        }
+        await execFileAsync(process.execPath, [cliPath, 'setup'], {
+            cwd: packageRoot,
+            env: {
+                ...process.env,
+                HOME: fakeHome,
+                USERPROFILE: fakeHome,
+                PATH: `${fakeBin}${path.delimiter}${process.env.PATH || ''}`,
+            },
+        });
+        const outputPath = path.join(fakeHome, '.codex', 'gitnexus-mcp-add.json');
+        const raw = await fs.readFile(outputPath, 'utf-8');
+        const parsed = JSON.parse(raw);
+        assert.deepEqual(parsed.args.slice(0, 4), ['mcp', 'add', 'gitnexus', '--']);
+        assert.ok(parsed.args.includes('gitnexus@latest'));
+        assert.ok(parsed.args.includes('mcp'));
+    }
+    finally {
+        await fs.rm(fakeHome, { recursive: true, force: true });
+        await fs.rm(fakeBin, { recursive: true, force: true });
+    }
+});

package/dist/mcp/server.d.ts

@@ -2,7 +2,7 @@
  * MCP Server (Multi-Repo)
  *
  * Model Context Protocol server that runs on stdio.
- * External AI tools (Cursor, Claude) spawn this process and
+ * External AI tools (Cursor, Claude, Codex, etc.) spawn this process and
  * communicate via stdin/stdout using the MCP protocol.
  *
  * Supports multiple indexed repositories via the global registry.

package/dist/mcp/server.js

@@ -2,7 +2,7 @@
  * MCP Server (Multi-Repo)
  *
  * Model Context Protocol server that runs on stdio.
- * External AI tools (Cursor, Claude) spawn this process and
+ * External AI tools (Cursor, Claude, Codex, etc.) spawn this process and
  * communicate via stdin/stdout using the MCP protocol.
  *
  * Supports multiple indexed repositories via the global registry.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@veewo/gitnexus",
-  "version": "1.3.4",
+  "version": "1.3.5",
   "description": "Graph-powered code intelligence for AI agents. Index any codebase, query via MCP or CLI.",
   "author": "Abhigyan Patwari",
   "license": "PolyForm-Noncommercial-1.0.0",