gitnexus 1.6.8-rc.23 → 1.6.8-rc.25

package/README.md

@@ -34,7 +34,7 @@ That's it. This indexes the codebase, installs agent skills, registers Claude Co
 
 To configure MCP for your editor, run `npx gitnexus setup` once — or set it up manually below.
 
-`gitnexus setup` auto-detects your editors and writes the correct global MCP config. You only need to run it once.
+`gitnexus setup` auto-detects your editors and writes the correct global MCP config. You only need to run it once. To configure only selected integrations, pass `--coding-agent`/`-c` with a comma-separated list or repeat the option, for example `gitnexus setup -c cursor,codex`.
 
 ### Editor Support
 
@@ -158,7 +158,7 @@ Your AI agent gets these tools automatically:
 ## CLI Commands
 
 ```bash
-gitnexus setup                   # Configure MCP for your editors (one-time)
+gitnexus setup                   # Configure MCP for detected editors (one-time; use -c to select)
 gitnexus uninstall               # Preview removal of GitNexus MCP/skills/hooks (add --force to apply)
 gitnexus analyze [path]          # Index a repository (or update stale index)
 gitnexus analyze --repair-fts    # Fast path: rebuild/verify only FTS indexes on existing index data

package/dist/cli/help-i18n.js

@@ -42,6 +42,7 @@ const COMMAND_DESCRIPTION_KEYS = {
 };
 const OPTION_DESCRIPTION_KEYS = {
     '|-V, --version': 'help.option.version',
+    'setup|-c, --coding-agent <agents>': 'help.option.setup.codingAgent',
     'analyze|-f, --force': 'help.option.analyze.force',
     'analyze|--repair-fts': 'help.option.analyze.repairFts',
     'analyze|--embeddings [limit]': 'help.option.analyze.embeddings',

package/dist/cli/i18n/en.d.ts

@@ -138,6 +138,7 @@ export declare const en: {
     readonly 'help.command.group.impact.description': "Cross-repo impact for a symbol in one member repo of a group";
     readonly 'help.command.group.query.description': "Search execution flows across all repos in a group";
     readonly 'help.command.group.contracts.description': "Inspect Contract Registry";
+    readonly 'help.option.setup.codingAgent': "Configure only these coding agents (comma-separated or repeatable)";
     readonly 'help.option.analyze.force': "Force full re-index even if up to date";
     readonly 'help.option.analyze.repairFts': "Repair/rebuild search FTS indexes without full re-analysis";
     readonly 'help.option.analyze.embeddings': "Enable embedding generation for semantic search (off by default). Optional [limit] overrides the 50,000-node safety cap; pass 0 to disable the cap entirely.";

package/dist/cli/i18n/en.js

@@ -138,6 +138,7 @@ export const en = {
     'help.command.group.impact.description': 'Cross-repo impact for a symbol in one member repo of a group',
     'help.command.group.query.description': 'Search execution flows across all repos in a group',
     'help.command.group.contracts.description': 'Inspect Contract Registry',
+    'help.option.setup.codingAgent': 'Configure only these coding agents (comma-separated or repeatable)',
     'help.option.analyze.force': 'Force full re-index even if up to date',
     'help.option.analyze.repairFts': 'Repair/rebuild search FTS indexes without full re-analysis',
     'help.option.analyze.embeddings': 'Enable embedding generation for semantic search (off by default). Optional [limit] overrides the 50,000-node safety cap; pass 0 to disable the cap entirely.',

package/dist/cli/i18n/resources.d.ts

@@ -139,6 +139,7 @@ export declare const cliResources: {
         readonly 'help.command.group.impact.description': "Cross-repo impact for a symbol in one member repo of a group";
         readonly 'help.command.group.query.description': "Search execution flows across all repos in a group";
         readonly 'help.command.group.contracts.description': "Inspect Contract Registry";
+        readonly 'help.option.setup.codingAgent': "Configure only these coding agents (comma-separated or repeatable)";
         readonly 'help.option.analyze.force': "Force full re-index even if up to date";
         readonly 'help.option.analyze.repairFts': "Repair/rebuild search FTS indexes without full re-analysis";
         readonly 'help.option.analyze.embeddings': "Enable embedding generation for semantic search (off by default). Optional [limit] overrides the 50,000-node safety cap; pass 0 to disable the cap entirely.";
@@ -365,6 +366,7 @@ export declare const cliResources: {
         'help.command.group.impact.description': string;
         'help.command.group.query.description': string;
         'help.command.group.contracts.description': string;
+        'help.option.setup.codingAgent': string;
         'help.option.analyze.force': string;
         'help.option.analyze.repairFts': string;
         'help.option.analyze.embeddings': string;

package/dist/cli/i18n/zh-CN.d.ts

@@ -138,6 +138,7 @@ export declare const zhCN: {
     'help.command.group.impact.description': string;
     'help.command.group.query.description': string;
     'help.command.group.contracts.description': string;
+    'help.option.setup.codingAgent': string;
     'help.option.analyze.force': string;
     'help.option.analyze.repairFts': string;
     'help.option.analyze.embeddings': string;

package/dist/cli/i18n/zh-CN.js

@@ -138,6 +138,7 @@ export const zhCN = {
     'help.command.group.impact.description': '分析仓库组中某个成员仓库符号的跨仓库影响',
     'help.command.group.query.description': '跨仓库组所有仓库搜索执行流程',
     'help.command.group.contracts.description': '查看 Contract Registry',
+    'help.option.setup.codingAgent': '仅配置这些编码代理（逗号分隔或重复传入）',
     'help.option.analyze.force': '即使已是最新也强制完整重建索引',
     'help.option.analyze.repairFts': '修复/重建搜索 FTS 索引，不执行完整重新分析',
     'help.option.analyze.embeddings': '启用语义搜索的嵌入生成（默认关闭）。可选 [limit] 覆盖 50,000 节点安全上限；传 0 可完全禁用上限。',

package/dist/cli/index.js

@@ -10,10 +10,14 @@ import { t } from './i18n/index.js';
 const _require = createRequire(import.meta.url);
 const pkg = _require('../../package.json');
 const program = new Command();
+function collectCodingAgents(value, previous) {
+    return [...(previous ?? []), ...value.split(',')];
+}
 program.name('gitnexus').description('GitNexus local CLI and MCP server').version(pkg.version);
 program
     .command('setup')
     .description('One-time setup: configure MCP for Cursor, Claude Code, Antigravity, OpenCode, Codex')
+    .option('-c, --coding-agent <agents>', 'Configure only these coding agents (comma-separated or repeatable)', collectCodingAgents)
     .action(createLazyAction(() => import('./setup.js'), 'setupCommand'));
 program
     .command('uninstall')

package/dist/cli/setup.d.ts

@@ -37,5 +37,7 @@ interface SetupResult {
  * install paths copy this same list from hooks/claude/ (the canonical source).
  */
 export declare function copyHookHelpers(srcDir: string, destDir: string, label: string, result: SetupResult): Promise<string[]>;
-export declare const setupCommand: () => Promise<void>;
+export declare const setupCommand: (options?: {
+    codingAgent?: string[] | string;
+}) => Promise<void>;
 export {};

package/dist/cli/setup.js

@@ -61,6 +61,33 @@ export function formatHookCommand(hookPath, isWindows = process.platform === 'wi
 // changes this literal, the guard records an actionable error instead of
 // silently shipping a hook with an unresolved relative cliPath.
 const CLI_PATH_SOURCE_LITERAL = "let cliPath = path.resolve(__dirname, '..', '..', 'dist', 'cli', 'index.js');";
+const CODING_AGENT_IDS = {
+    cursor: 'cursor',
+    claude: 'claude',
+    antigravity: 'antigravity',
+    opencode: 'opencode',
+    codex: 'codex',
+};
+const SUPPORTED_CODING_AGENTS = Object.values(CODING_AGENT_IDS);
+function selectedCodingAgents(values) {
+    if (values == null)
+        return new Set(SUPPORTED_CODING_AGENTS);
+    const rawValues = Array.isArray(values) ? values : [values];
+    const requested = rawValues
+        .flatMap((value) => value.split(','))
+        .map((value) => value.trim().toLowerCase())
+        .filter(Boolean);
+    const invalid = requested.filter((value) => !SUPPORTED_CODING_AGENTS.includes(value));
+    if (requested.length === 0 || invalid.length > 0) {
+        const detail = requested.length === 0
+            ? 'No coding agents were provided.'
+            : `Unknown: ${invalid.join(', ')}.`;
+        process.stderr.write(`${detail} Valid values: ${SUPPORTED_CODING_AGENTS.join(', ')}.\n`);
+        process.exitCode = 1;
+        return null;
+    }
+    return new Set(requested);
+}
 /**
  * Resolve the absolute path to the `gitnexus` binary if it's installed
  * globally (or via npm -g / yarn global). Returns null when not found.
@@ -832,7 +859,11 @@ async function installCodexSkills(result) {
     }
 }
 // ─── Main command ──────────────────────────────────────────────────
-export const setupCommand = async () => {
+export const setupCommand = async (options) => {
+    const explicitSelection = options?.codingAgent != null;
+    const selected = selectedCodingAgents(options?.codingAgent);
+    if (!selected)
+        return;
     console.log('');
     console.log('  GitNexus Setup');
     console.log('  ==============');
@@ -846,19 +877,31 @@ export const setupCommand = async () => {
         errors: [],
     };
     // Detect and configure each editor's MCP
-    await setupCursor(result);
-    await setupClaudeCode(result);
-    await setupAntigravity(result);
-    await setupOpenCode(result);
-    await setupCodex(result);
+    if (selected.has('cursor'))
+        await setupCursor(result);
+    if (selected.has('claude'))
+        await setupClaudeCode(result);
+    if (selected.has('antigravity'))
+        await setupAntigravity(result);
+    if (selected.has('opencode'))
+        await setupOpenCode(result);
+    if (selected.has('codex'))
+        await setupCodex(result);
     // Install global skills for platforms that support them
-    await installClaudeCodeSkills(result);
-    await installClaudeCodeHooks(result);
-    await installAntigravitySkills(result);
-    await installAntigravityHooks(result);
-    await installCursorSkills(result);
-    await installOpenCodeSkills(result);
-    await installCodexSkills(result);
+    if (selected.has('claude')) {
+        await installClaudeCodeSkills(result);
+        await installClaudeCodeHooks(result);
+    }
+    if (selected.has('antigravity')) {
+        await installAntigravitySkills(result);
+        await installAntigravityHooks(result);
+    }
+    if (selected.has('cursor'))
+        await installCursorSkills(result);
+    if (selected.has('opencode'))
+        await installOpenCodeSkills(result);
+    if (selected.has('codex'))
+        await installCodexSkills(result);
     // Print results
     if (result.configured.length > 0) {
         console.log('  Configured:');
@@ -884,10 +927,17 @@ export const setupCommand = async () => {
     console.log('  Summary:');
     console.log(`    MCP configured for: ${result.configured.filter((c) => !c.includes('skills')).join(', ') || 'none'}`);
     console.log(`    Skills installed to: ${result.configured.filter((c) => c.includes('skills')).length > 0 ? result.configured.filter((c) => c.includes('skills')).join(', ') : 'none'}`);
+    const configurationSucceeded = result.configured.length > 0;
+    if (explicitSelection && !configurationSucceeded) {
+        process.stderr.write('None of the explicitly selected coding agents were configured.\n');
+        process.exitCode = 1;
+    }
     console.log('');
-    console.log('  Next steps:');
-    console.log('    1. cd into any git repo');
-    console.log('    2. Run: gitnexus analyze');
-    console.log('    3. Open the repo in your editor — MCP is ready!');
+    if (configurationSucceeded) {
+        console.log('  Next steps:');
+        console.log('    1. cd into any git repo');
+        console.log('    2. Run: gitnexus analyze');
+        console.log('    3. Open the repo in your editor — MCP is ready!');
+    }
     console.log('');
 };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "gitnexus",
-  "version": "1.6.8-rc.23",
+  "version": "1.6.8-rc.25",
   "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",