gitnexus 1.6.9 → 1.6.10-rc.10

package/dist/cli/embeddings.d.ts

@@ -0,0 +1,12 @@
+export interface EmbeddingsInstallOptions {
+    cuda?: boolean;
+    force?: boolean;
+}
+/**
+ * `gitnexus embeddings install [--cuda] [--force]` — fetch the optional local
+ * embedding stack on demand (#2370). Goes through the user's npm registry
+ * config (mirrors/proxies apply); with --cuda it additionally runs
+ * onnxruntime-node's postinstall to download the CUDA GPU binaries from NuGet
+ * (set GLOBAL_AGENT_HTTPS_PROXY behind a proxy).
+ */
+export declare const embeddingsInstallCommand: (options?: EmbeddingsInstallOptions) => Promise<void>;

package/dist/cli/embeddings.js

@@ -0,0 +1,49 @@
+import { cliError, cliInfo, cliWarn } from './cli-message.js';
+import { getEmbeddingRuntimeDir, getEmbeddingStackSpecs, installEmbeddingRuntime, isPrefixRuntimeLoadable, resolveEmbeddingRuntime, } from '../core/embeddings/runtime-install.js';
+import { localEmbeddingPrefixUnloadableMessage } from '../core/embeddings/runtime-support.js';
+/**
+ * `gitnexus embeddings install [--cuda] [--force]` — fetch the optional local
+ * embedding stack on demand (#2370). Goes through the user's npm registry
+ * config (mirrors/proxies apply); with --cuda it additionally runs
+ * onnxruntime-node's postinstall to download the CUDA GPU binaries from NuGet
+ * (set GLOBAL_AGENT_HTTPS_PROXY behind a proxy).
+ */
+export const embeddingsInstallCommand = async (options = {}) => {
+    const resolved = resolveEmbeddingRuntime();
+    if (resolved?.source === 'package' && !options.force) {
+        cliInfo('The embedding stack is already installed with gitnexus itself — nothing to do.\n' +
+            '(Use --force to install a copy into the runtime prefix anyway.)');
+        return;
+    }
+    const specs = Object.entries(getEmbeddingStackSpecs())
+        .map(([name, spec]) => `${name}@${spec}`)
+        .join(', ');
+    cliInfo(`Installing ${specs} into ${getEmbeddingRuntimeDir()} …`);
+    cliInfo(options.cuda
+        ? 'CUDA mode: onnxruntime-node will download GPU binaries from NuGet ' +
+            '(set GLOBAL_AGENT_HTTPS_PROXY=<proxy-url> behind a proxy).'
+        : 'CPU mode: install scripts are skipped — only your npm registry is contacted.');
+    try {
+        await installEmbeddingRuntime({ cuda: options.cuda, onOutput: (line) => cliInfo(`  ${line}`) });
+    }
+    catch (err) {
+        cliError(`${err instanceof Error ? err.message : String(err)}\n`, {
+            recoveryHint: 'local-embedding-stack-missing',
+        });
+        process.exitCode = 1;
+        return;
+    }
+    const postInstall = resolveEmbeddingRuntime();
+    if (postInstall === null) {
+        cliInfo('✗ Install completed but the stack still does not resolve — check the output above.');
+        process.exitCode = 1;
+        return;
+    }
+    if (postInstall.source === 'runtime-prefix' && !isPrefixRuntimeLoadable()) {
+        // The packages are in the prefix, but this Node has no module.registerHooks
+        // to load them — don't claim readiness the loader can't honour.
+        cliWarn(`${localEmbeddingPrefixUnloadableMessage()}\n`);
+        return;
+    }
+    cliInfo('✓ Embedding runtime installed. `gitnexus analyze --embeddings` is ready.');
+};

package/dist/cli/help-i18n.js

@@ -17,6 +17,8 @@ const COMMAND_DESCRIPTION_KEYS = {
     list: 'help.command.list.description',
     status: 'help.command.status.description',
     doctor: 'help.command.doctor.description',
+    embeddings: 'help.command.embeddings.description',
+    'embeddings install': 'help.command.embeddings.install.description',
     clean: 'help.command.clean.description',
     remove: 'help.command.remove.description',
     wiki: 'help.command.wiki.description',
@@ -143,6 +145,8 @@ const OPTION_DESCRIPTION_KEYS = {
     'eval-server|-p, --port <port>': 'help.option.port',
     'eval-server|--host <host>': 'help.option.evalServer.host',
     'eval-server|--idle-timeout <seconds>': 'help.option.evalServer.idleTimeout',
+    'embeddings install|--cuda': 'help.option.embeddings.install.cuda',
+    'embeddings install|--force': 'help.option.embeddings.install.force',
     'group create|--force': 'help.option.group.create.force',
     'group sync|--skip-embeddings': 'help.option.group.sync.skipEmbeddings',
     'group sync|--exact-only': 'help.option.group.sync.exactOnly',

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

@@ -108,7 +108,7 @@ export declare const en: {
     readonly 'help.command.help.description': "display help for command";
     readonly 'help.option.help': "display help for command";
     readonly 'help.option.version': "output the version number";
-    readonly 'help.command.setup.description': "One-time setup: configure MCP for Cursor, Claude Code, OpenCode, Codex";
+    readonly 'help.command.setup.description': "One-time setup: configure MCP for Cursor, Claude Code, Antigravity, OpenCode, CodeBuddy, Qoder, Codex";
     readonly 'help.command.uninstall.description': "Reverse `setup`: remove GitNexus MCP entries, skills, and hooks from all detected editors";
     readonly 'help.command.analyze.description': "Index a repository (full analysis)";
     readonly 'help.command.index.description': "Register an existing .gitnexus/ folder into the global registry (no re-analysis needed)";
@@ -117,6 +117,8 @@ export declare const en: {
     readonly 'help.command.list.description': "List all indexed repositories";
     readonly 'help.command.status.description': "Show index status for current repo";
     readonly 'help.command.doctor.description': "Show runtime platform capabilities and embedding configuration";
+    readonly 'help.command.embeddings.description': "Manage the on-demand local embedding runtime";
+    readonly 'help.command.embeddings.install.description': "Install the local embedding stack (@huggingface/transformers + onnxruntime-node) on demand. Heals installs where npm skipped the optional packages (e.g. behind an HTTP proxy, #2370). Downloads only from your configured npm registry — mirrors and proxies apply.";
     readonly 'help.command.clean.description': "Delete GitNexus index for current repo";
     readonly 'help.command.remove.description': "Delete the GitNexus index for a registered repo (by alias, name, or absolute path). Unlike `clean`, does not require being inside the repo. Idempotent on unknown targets.";
     readonly 'help.command.wiki.description': "Generate repository wiki from knowledge graph";
@@ -220,6 +222,8 @@ export declare const en: {
     readonly 'help.option.check.cycles': "Detect circular imports and fail when any are found";
     readonly 'help.option.evalServer.host': "Bind address (default: 127.0.0.1, use 0.0.0.0 to expose to all interfaces)";
     readonly 'help.option.evalServer.idleTimeout': "Auto-shutdown after N seconds idle (0 = disabled)";
+    readonly 'help.option.embeddings.install.cuda': "Also download the CUDA GPU binaries (runs onnxruntime-node's NuGet postinstall; set GLOBAL_AGENT_HTTPS_PROXY behind a proxy)";
+    readonly 'help.option.embeddings.install.force': "Install into the runtime prefix even when the stack already resolves";
     readonly 'help.option.group.create.force': "Overwrite existing group";
     readonly 'help.option.group.sync.skipEmbeddings': "Exact + BM25 only (no embedding fallback)";
     readonly 'help.option.group.sync.exactOnly': "Exact match only";

package/dist/cli/i18n/en.js

@@ -108,7 +108,7 @@ export const en = {
     'help.command.help.description': 'display help for command',
     'help.option.help': 'display help for command',
     'help.option.version': 'output the version number',
-    'help.command.setup.description': 'One-time setup: configure MCP for Cursor, Claude Code, OpenCode, Codex',
+    'help.command.setup.description': 'One-time setup: configure MCP for Cursor, Claude Code, Antigravity, OpenCode, CodeBuddy, Qoder, Codex',
     'help.command.uninstall.description': 'Reverse `setup`: remove GitNexus MCP entries, skills, and hooks from all detected editors',
     'help.command.analyze.description': 'Index a repository (full analysis)',
     'help.command.index.description': 'Register an existing .gitnexus/ folder into the global registry (no re-analysis needed)',
@@ -117,6 +117,8 @@ export const en = {
     'help.command.list.description': 'List all indexed repositories',
     'help.command.status.description': 'Show index status for current repo',
     'help.command.doctor.description': 'Show runtime platform capabilities and embedding configuration',
+    'help.command.embeddings.description': 'Manage the on-demand local embedding runtime',
+    'help.command.embeddings.install.description': 'Install the local embedding stack (@huggingface/transformers + onnxruntime-node) on demand. Heals installs where npm skipped the optional packages (e.g. behind an HTTP proxy, #2370). Downloads only from your configured npm registry — mirrors and proxies apply.',
     'help.command.clean.description': 'Delete GitNexus index for current repo',
     'help.command.remove.description': 'Delete the GitNexus index for a registered repo (by alias, name, or absolute path). Unlike `clean`, does not require being inside the repo. Idempotent on unknown targets.',
     'help.command.wiki.description': 'Generate repository wiki from knowledge graph',
@@ -220,6 +222,8 @@ export const en = {
     'help.option.check.cycles': 'Detect circular imports and fail when any are found',
     'help.option.evalServer.host': 'Bind address (default: 127.0.0.1, use 0.0.0.0 to expose to all interfaces)',
     'help.option.evalServer.idleTimeout': 'Auto-shutdown after N seconds idle (0 = disabled)',
+    'help.option.embeddings.install.cuda': "Also download the CUDA GPU binaries (runs onnxruntime-node's NuGet postinstall; set GLOBAL_AGENT_HTTPS_PROXY behind a proxy)",
+    'help.option.embeddings.install.force': 'Install into the runtime prefix even when the stack already resolves',
     'help.option.group.create.force': 'Overwrite existing group',
     'help.option.group.sync.skipEmbeddings': 'Exact + BM25 only (no embedding fallback)',
     'help.option.group.sync.exactOnly': 'Exact match only',

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

@@ -109,7 +109,7 @@ export declare const cliResources: {
         readonly 'help.command.help.description': "display help for command";
         readonly 'help.option.help': "display help for command";
         readonly 'help.option.version': "output the version number";
-        readonly 'help.command.setup.description': "One-time setup: configure MCP for Cursor, Claude Code, OpenCode, Codex";
+        readonly 'help.command.setup.description': "One-time setup: configure MCP for Cursor, Claude Code, Antigravity, OpenCode, CodeBuddy, Qoder, Codex";
         readonly 'help.command.uninstall.description': "Reverse `setup`: remove GitNexus MCP entries, skills, and hooks from all detected editors";
         readonly 'help.command.analyze.description': "Index a repository (full analysis)";
         readonly 'help.command.index.description': "Register an existing .gitnexus/ folder into the global registry (no re-analysis needed)";
@@ -118,6 +118,8 @@ export declare const cliResources: {
         readonly 'help.command.list.description': "List all indexed repositories";
         readonly 'help.command.status.description': "Show index status for current repo";
         readonly 'help.command.doctor.description': "Show runtime platform capabilities and embedding configuration";
+        readonly 'help.command.embeddings.description': "Manage the on-demand local embedding runtime";
+        readonly 'help.command.embeddings.install.description': "Install the local embedding stack (@huggingface/transformers + onnxruntime-node) on demand. Heals installs where npm skipped the optional packages (e.g. behind an HTTP proxy, #2370). Downloads only from your configured npm registry — mirrors and proxies apply.";
         readonly 'help.command.clean.description': "Delete GitNexus index for current repo";
         readonly 'help.command.remove.description': "Delete the GitNexus index for a registered repo (by alias, name, or absolute path). Unlike `clean`, does not require being inside the repo. Idempotent on unknown targets.";
         readonly 'help.command.wiki.description': "Generate repository wiki from knowledge graph";
@@ -221,6 +223,8 @@ export declare const cliResources: {
         readonly 'help.option.check.cycles': "Detect circular imports and fail when any are found";
         readonly 'help.option.evalServer.host': "Bind address (default: 127.0.0.1, use 0.0.0.0 to expose to all interfaces)";
         readonly 'help.option.evalServer.idleTimeout': "Auto-shutdown after N seconds idle (0 = disabled)";
+        readonly 'help.option.embeddings.install.cuda': "Also download the CUDA GPU binaries (runs onnxruntime-node's NuGet postinstall; set GLOBAL_AGENT_HTTPS_PROXY behind a proxy)";
+        readonly 'help.option.embeddings.install.force': "Install into the runtime prefix even when the stack already resolves";
         readonly 'help.option.group.create.force': "Overwrite existing group";
         readonly 'help.option.group.sync.skipEmbeddings': "Exact + BM25 only (no embedding fallback)";
         readonly 'help.option.group.sync.exactOnly': "Exact match only";
@@ -360,6 +364,8 @@ export declare const cliResources: {
         'help.command.list.description': string;
         'help.command.status.description': string;
         'help.command.doctor.description': string;
+        'help.command.embeddings.description': string;
+        'help.command.embeddings.install.description': string;
         'help.command.clean.description': string;
         'help.command.remove.description': string;
         'help.command.wiki.description': string;
@@ -463,6 +469,8 @@ export declare const cliResources: {
         'help.option.check.cycles': string;
         'help.option.evalServer.host': string;
         'help.option.evalServer.idleTimeout': string;
+        'help.option.embeddings.install.cuda': string;
+        'help.option.embeddings.install.force': string;
         'help.option.group.create.force': string;
         'help.option.group.sync.skipEmbeddings': string;
         'help.option.group.sync.exactOnly': string;

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

@@ -117,6 +117,8 @@ export declare const zhCN: {
     'help.command.list.description': string;
     'help.command.status.description': string;
     'help.command.doctor.description': string;
+    'help.command.embeddings.description': string;
+    'help.command.embeddings.install.description': string;
     'help.command.clean.description': string;
     'help.command.remove.description': string;
     'help.command.wiki.description': string;
@@ -220,6 +222,8 @@ export declare const zhCN: {
     'help.option.check.cycles': string;
     'help.option.evalServer.host': string;
     'help.option.evalServer.idleTimeout': string;
+    'help.option.embeddings.install.cuda': string;
+    'help.option.embeddings.install.force': string;
     'help.option.group.create.force': string;
     'help.option.group.sync.skipEmbeddings': string;
     'help.option.group.sync.exactOnly': string;

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

@@ -108,7 +108,7 @@ export const zhCN = {
     'help.command.help.description': '显示命令帮助',
     'help.option.help': '显示命令帮助',
     'help.option.version': '输出版本号',
-    'help.command.setup.description': '一次性设置：为 Cursor、Claude Code、OpenCode、Codex 配置 MCP',
+    'help.command.setup.description': '一次性设置：为 Cursor、Claude Code、Antigravity、OpenCode、CodeBuddy、Qoder、Codex 配置 MCP',
     'help.command.uninstall.description': '撤销 `setup`：从所有检测到的编辑器中移除 GitNexus 的 MCP 配置、技能和钩子',
     'help.command.analyze.description': '索引仓库（完整分析）',
     'help.command.index.description': '将现有 .gitnexus/ 文件夹注册到全局注册表（无需重新分析）',
@@ -117,6 +117,8 @@ export const zhCN = {
     'help.command.list.description': '列出所有已索引仓库',
     'help.command.status.description': '显示当前仓库的索引状态',
     'help.command.doctor.description': '显示运行平台能力和嵌入配置',
+    'help.command.embeddings.description': '管理按需安装的本地嵌入运行时',
+    'help.command.embeddings.install.description': '按需安装本地嵌入组件（@huggingface/transformers + onnxruntime-node）。修复 npm 跳过可选包的安装（例如在 HTTP 代理后，#2370）。仅从你配置的 npm registry 下载 — 镜像和代理均生效。',
     'help.command.clean.description': '删除当前仓库的 GitNexus 索引',
     'help.command.remove.description': '删除已注册仓库的 GitNexus 索引（按别名、名称或绝对路径）。与 `clean` 不同，不要求位于仓库内；未知目标会幂等处理。',
     'help.command.wiki.description': '从知识图谱生成仓库 Wiki',
@@ -220,6 +222,8 @@ export const zhCN = {
     'help.option.check.cycles': '检测循环导入，并在发现循环时失败',
     'help.option.evalServer.host': '绑定地址（默认：127.0.0.1；用 0.0.0.0 暴露到所有网卡）',
     'help.option.evalServer.idleTimeout': '空闲 N 秒后自动关闭（0 = 禁用）',
+    'help.option.embeddings.install.cuda': '同时下载 CUDA GPU 二进制文件（运行 onnxruntime-node 的 NuGet postinstall；代理后请设置 GLOBAL_AGENT_HTTPS_PROXY）',
+    'help.option.embeddings.install.force': '即使嵌入组件已可解析，也强制安装到运行时目录',
     'help.option.group.create.force': '覆盖现有仓库组',
     'help.option.group.sync.skipEmbeddings': '仅使用 exact + BM25（不使用嵌入回退）',
     'help.option.group.sync.exactOnly': '仅精确匹配',

package/dist/cli/index.js

@@ -17,7 +17,7 @@ function collectCodingAgents(value, previous) {
 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')
+    .description('One-time setup: configure MCP for Cursor, Claude Code, Antigravity, OpenCode, CodeBuddy, Qoder, Codex')
     .option('-c, --coding-agent <agents>', 'Configure only these coding agents (comma-separated or repeatable)', collectCodingAgents)
     .action(createLazyAction(() => import('./setup.js'), 'setupCommand'));
 program
@@ -153,6 +153,17 @@ program
     .command('doctor')
     .description('Show runtime platform capabilities and embedding configuration')
     .action(createLazyAction(() => import('./doctor.js'), 'doctorCommand'));
+program
+    .command('embeddings')
+    .description('Manage the on-demand local embedding runtime')
+    .command('install')
+    .description('Install the local embedding stack (@huggingface/transformers + onnxruntime-node) on demand. ' +
+    'Heals installs where npm skipped the optional packages (e.g. behind an HTTP proxy, #2370). ' +
+    'Downloads only from your configured npm registry — mirrors and proxies apply.')
+    .option('--cuda', "Also download the CUDA GPU binaries (runs onnxruntime-node's NuGet postinstall; " +
+    'set GLOBAL_AGENT_HTTPS_PROXY behind a proxy)')
+    .option('--force', 'Install into the runtime prefix even when the stack already resolves')
+    .action(createLazyAction(() => import('./embeddings.js'), 'embeddingsInstallCommand'));
 program
     .command('clean')
     .description('Delete GitNexus index for current repo')

package/dist/cli/setup.js

@@ -14,7 +14,7 @@ import { promisify } from 'util';
 import { fileURLToPath } from 'url';
 import { parseTree, modify, applyEdits, parse as parseJsonc } from 'jsonc-parser';
 import { getGlobalDir } from '../storage/repo-manager.js';
-import { getEditorTargets, mcpTarget, skillTarget, hookTarget, detectIndentation, } from './editor-targets.js';
+import { getEditorTargets, mcpTarget, skillTarget, hookTarget, detectIndentation, isEnoent, } from './editor-targets.js';
 const __filename = fileURLToPath(import.meta.url);
 const __dirname = path.dirname(__filename);
 const execFileAsync = promisify(execFile);
@@ -66,6 +66,8 @@ const CODING_AGENT_IDS = {
     claude: 'claude',
     antigravity: 'antigravity',
     opencode: 'opencode',
+    codebuddy: 'codebuddy',
+    qoder: 'qoder',
     codex: 'codex',
 };
 const SUPPORTED_CODING_AGENTS = Object.values(CODING_AGENT_IDS);
@@ -173,7 +175,13 @@ async function mergeJsoncFile(filePath, keyPath, value) {
     try {
         raw = await fs.readFile(filePath, 'utf-8');
     }
-    catch {
+    catch (err) {
+        // Only an absent file means "start fresh". Any other read failure (EACCES,
+        // EIO, cloud-placeholder faults) must not be treated as empty — the write
+        // below would replace the user's existing config with a gitnexus-only
+        // document and report success. Rethrow into the per-editor catch instead.
+        if (!isEnoent(err))
+            throw err;
         raw = '';
     }
     if (raw.trim().length === 0) {
@@ -207,6 +215,35 @@ async function dirExists(dirPath) {
         return false;
     }
 }
+/**
+ * Detection probe: is there a non-empty regular file at this path?
+ * Swallows ALL errors (like dirExists) — detection gates run outside the
+ * per-editor try blocks, so a rethrowing probe would abort setup for every
+ * remaining editor. Size > 0 keeps detection aligned with the config-chain
+ * resolver: an empty config file is not evidence of an install, and treating
+ * it as one would route the write to a fresh file whose mkdir manufactures
+ * the editor's directory.
+ */
+async function isNonEmptyFile(filePath) {
+    try {
+        const stat = await fs.stat(filePath);
+        return stat.isFile() && stat.size > 0;
+    }
+    catch {
+        return false;
+    }
+}
+/**
+ * Detection probe: does any file in the target's MCP config chain look like an
+ * install trace? Always walks [file, ...legacyFiles] so an editor gaining
+ * legacyFiles later is automatically covered (CodeBuddy and Qoder share this —
+ * a per-editor copy is how the root-config-only detection gap crept in, see
+ * PR #2368 review I4).
+ */
+async function anyChainConfigFile(target) {
+    const hits = await Promise.all([target.file, ...(target.legacyFiles ?? [])].map(isNonEmptyFile));
+    return hits.includes(true);
+}
 // ─── Editor-specific setup ─────────────────────────────────────────
 async function setupCursor(result) {
     const cursorDir = path.join(os.homedir(), '.cursor');
@@ -287,7 +324,12 @@ async function mergeHooksJsonc(filePath, entries) {
     try {
         raw = await fs.readFile(filePath, 'utf-8');
     }
-    catch {
+    catch (err) {
+        // Same contract as mergeJsoncFile: an unreadable (non-ENOENT) settings
+        // file must not be rewritten as hooks-only — that would destroy every
+        // user setting in it. Rethrow into the hook installer's catch.
+        if (!isEnoent(err))
+            throw err;
         raw = '';
     }
     if (raw.trim().length === 0) {
@@ -365,20 +407,26 @@ export async function copyHookHelpers(srcDir, destDir, label, result) {
     return failedRequired;
 }
 /**
- * Install GitNexus hooks to ~/.claude/settings.json for Claude Code.
- * Merges hook config without overwriting existing hooks, preserving
- * comments and formatting in the JSONC file.
+ * Install GitNexus hooks for editors that use Claude Code's hooks schema.
+ *
+ * Claude Code registers hooks in ~/.claude/settings.json; Codex uses a
+ * dedicated ~/.codex/hooks.json with the identical {hooks: {Event: [...]}}
+ * JSON shape, stdin payload, and hookSpecificOutput response contract
+ * (https://developers.openai.com/codex/hooks), so both runtimes share this
+ * installer and the same bundled adapter script. Merges hook config without
+ * overwriting existing hooks, preserving comments and formatting.
  */
-async function installClaudeCodeHooks(result) {
-    const claudeDir = path.join(os.homedir(), '.claude');
-    if (!(await dirExists(claudeDir)))
+async function installClaudeSchemaHooks(result, id) {
+    const hookCfg = hookTarget(id);
+    const settingsPath = hookCfg.settingsFile;
+    const label = `${hookCfg.label} hooks`;
+    // Gate on the editor's own config dir (~/.claude, ~/.codex) existing.
+    if (!(await dirExists(path.dirname(settingsPath))))
         return;
-    const claudeHook = hookTarget('claude');
-    const settingsPath = claudeHook.settingsFile;
     // Source hooks bundled within the gitnexus package (hooks/claude/)
     const pluginHooksPath = path.join(__dirname, '..', '..', 'hooks', 'claude');
-    // Copy unified hook script to ~/.claude/hooks/gitnexus/
-    const destHooksDir = claudeHook.scriptDir;
+    // Copy unified hook script to the editor's hooks/gitnexus/ dir
+    const destHooksDir = hookCfg.scriptDir;
     try {
         await fs.mkdir(destHooksDir, { recursive: true });
         const src = path.join(pluginHooksPath, 'gitnexus-hook.cjs');
@@ -389,7 +437,7 @@ async function installClaudeCodeHooks(result) {
             const normalizedCli = path.resolve(resolvedCli).replace(/\\/g, '/');
             const jsonCli = JSON.stringify(normalizedCli);
             if (!content.includes(CLI_PATH_SOURCE_LITERAL)) {
-                result.errors.push('Claude Code hooks: gitnexus-hook.cjs no longer contains the cliPath literal to patch — the installed hook may fail to resolve the CLI. Update CLI_PATH_SOURCE_LITERAL in setup.ts.');
+                result.errors.push(`${label}: gitnexus-hook.cjs no longer contains the cliPath literal to patch — the installed hook may fail to resolve the CLI. Update CLI_PATH_SOURCE_LITERAL in setup.ts.`);
             }
             content = content.replace(CLI_PATH_SOURCE_LITERAL, `let cliPath = ${jsonCli};`);
             await fs.writeFile(dest, content, 'utf-8');
@@ -404,12 +452,12 @@ async function installClaudeCodeHooks(result) {
             await fs.access(dest);
         }
         catch {
-            result.errors.push('Claude Code hooks: adapter script was not installed — skipping hook registration');
+            result.errors.push(`${label}: adapter script was not installed — skipping hook registration`);
             return;
         }
-        const failedRequired = await copyHookHelpers(pluginHooksPath, destHooksDir, 'Claude Code hooks', result);
+        const failedRequired = await copyHookHelpers(pluginHooksPath, destHooksDir, label, result);
         if (failedRequired.length > 0) {
-            result.errors.push(`Claude Code hooks: required helper(s) ${failedRequired.join(', ')} failed to copy — skipping hook registration`);
+            result.errors.push(`${label}: required helper(s) ${failedRequired.join(', ')} failed to copy — skipping hook registration`);
             return;
         }
         const hookPath = path.join(destHooksDir, 'gitnexus-hook.cjs').replace(/\\/g, '/');
@@ -425,9 +473,10 @@ async function installClaudeCodeHooks(result) {
             }
         })();
         const hookEntries = [];
-        // NOTE: SessionStart hooks are broken on Windows (Claude Code bug #23576).
-        // Session context is delivered via CLAUDE.md / skills instead.
-        if (!hasGitnexusHook(parsed?.hooks, 'PreToolUse', claudeHook.needle)) {
+        // NOTE: SessionStart hooks are broken on Windows (Claude Code bug #23576),
+        // and Codex reads AGENTS.md natively. Session context is delivered via
+        // CLAUDE.md / AGENTS.md / skills instead.
+        if (!hasGitnexusHook(parsed?.hooks, 'PreToolUse', hookCfg.needle)) {
             hookEntries.push({
                 eventName: 'PreToolUse',
                 value: {
@@ -443,7 +492,7 @@ async function installClaudeCodeHooks(result) {
                 },
             });
         }
-        if (!hasGitnexusHook(parsed?.hooks, 'PostToolUse', claudeHook.needle)) {
+        if (!hasGitnexusHook(parsed?.hooks, 'PostToolUse', hookCfg.needle)) {
             hookEntries.push({
                 eventName: 'PostToolUse',
                 value: {
@@ -460,19 +509,19 @@ async function installClaudeCodeHooks(result) {
             });
         }
         if (hookEntries.length === 0) {
-            result.configured.push('Claude Code hooks (already configured)');
+            result.configured.push(`${label} (already configured)`);
             return;
         }
         const ok = await mergeHooksJsonc(settingsPath, hookEntries);
         if (ok) {
-            result.configured.push('Claude Code hooks (PreToolUse, PostToolUse)');
+            result.configured.push(`${label} (PreToolUse, PostToolUse)`);
         }
         else {
-            result.errors.push('Claude Code hooks: settings.json is corrupt — skipping to preserve existing content');
+            result.errors.push(`${label}: ${path.basename(settingsPath)} is corrupt — skipping to preserve existing content`);
         }
     }
     catch (err) {
-        result.errors.push(`Claude Code hooks: ${err.message}`);
+        result.errors.push(`${label}: ${err.message}`);
     }
 }
 // ─── Antigravity (Google) ──────────────────────────────────────────
@@ -660,6 +709,118 @@ async function setupOpenCode(result) {
         result.errors.push(`OpenCode: ${err.message}`);
     }
 }
+/**
+ * Resolve which config file in a target's [file, ...legacyFiles] priority
+ * chain setup should write into: the first that exists, else the recommended
+ * `file`. CodeBuddy reads only the first existing file in its chain, so
+ * creating the recommended file above a populated deprecated one would shadow
+ * the user's existing MCP servers.
+ */
+async function resolveMcpConfigFile(target) {
+    for (const candidate of [target.file, ...(target.legacyFiles ?? [])]) {
+        try {
+            const stat = await fs.stat(candidate);
+            // Non-empty regular files only: a 0-byte recommended file must not
+            // shadow a populated deprecated one (mergeJsoncFile treats empty as a
+            // fresh document anyway), and directories are never config candidates.
+            if (stat.isFile() && stat.size > 0)
+                return candidate;
+        }
+        catch (err) {
+            // ENOENT = candidate absent — try the next one. Anything else (EACCES
+            // on the file or a parent) is surfaced: silently skipping could route
+            // the write to a lower-priority file the editor never reads.
+            if (!isEnoent(err))
+                throw err;
+        }
+    }
+    return target.file;
+}
+async function setupCodeBuddy(result) {
+    const codebuddyDir = path.join(os.homedir(), '.codebuddy');
+    const target = mcpTarget('codebuddy');
+    // Installed = the config dir exists OR any registered MCP config file does.
+    // A user whose only trace is a root-level config (e.g. a legacy
+    // ~/.codebuddy.json) still gets configured — uninstall already handles that
+    // shape, so setup skipping it was an asymmetry (PR #2368 review I4).
+    if (!(await dirExists(codebuddyDir)) && !(await anyChainConfigFile(target))) {
+        result.skipped.push('CodeBuddy (not installed)');
+        return;
+    }
+    try {
+        const configFile = await resolveMcpConfigFile(target);
+        const ok = await mergeJsoncFile(configFile, target.keyPath, getMcpEntry());
+        if (ok) {
+            result.configured.push('CodeBuddy');
+        }
+        else {
+            result.errors.push(`CodeBuddy: ${path.basename(configFile)} is corrupt — skipping to preserve existing content`);
+        }
+    }
+    catch (err) {
+        result.errors.push(`CodeBuddy: ${err instanceof Error ? err.message : String(err)}`);
+    }
+}
+async function setupQoder(result) {
+    const qoderDir = path.join(os.homedir(), '.qoder');
+    const target = mcpTarget('qoder');
+    const { file: mcpPath, keyPath } = target;
+    // Same chain-aware detection as CodeBuddy: ~/.qoder.json alone counts.
+    if (!(await dirExists(qoderDir)) && !(await anyChainConfigFile(target))) {
+        result.skipped.push('Qoder (not installed)');
+        return;
+    }
+    try {
+        const ok = await mergeJsoncFile(mcpPath, keyPath, getMcpEntry());
+        if (ok) {
+            result.configured.push('Qoder');
+        }
+        else {
+            result.errors.push('Qoder: .qoder.json is corrupt — skipping to preserve existing content');
+        }
+    }
+    catch (err) {
+        result.errors.push(`Qoder: ${err instanceof Error ? err.message : String(err)}`);
+    }
+}
+/**
+ * Install global CodeBuddy skills to ~/.codebuddy/skills/
+ * (https://www.codebuddy.ai/docs/cli/skills — same SKILL.md layout as Claude Code).
+ */
+async function installCodeBuddySkills(result) {
+    const codebuddyDir = path.join(os.homedir(), '.codebuddy');
+    if (!(await dirExists(codebuddyDir)))
+        return;
+    const skillsDir = skillTarget('codebuddy').dir;
+    try {
+        const installed = await installSkillsTo(skillsDir);
+        if (installed.length > 0) {
+            result.configured.push(`CodeBuddy skills (${installed.length} skills → ~/.codebuddy/skills/)`);
+        }
+    }
+    catch (err) {
+        result.errors.push(`CodeBuddy skills: ${err instanceof Error ? err.message : String(err)}`);
+    }
+}
+/**
+ * Install global Qoder skills to ~/.qoder/skills/
+ * (https://docs.qoder.com/extensions/skills — same SKILL.md layout as Claude Code).
+ */
+async function installQoderSkills(result) {
+    const qoderDir = path.join(os.homedir(), '.qoder');
+    if (!(await dirExists(qoderDir)))
+        return;
+    const skillsDir = skillTarget('qoder').dir;
+    try {
+        const installed = await installSkillsTo(skillsDir);
+        if (installed.length > 0) {
+            result.configured.push(`Qoder skills (${installed.length} skills → ~/.qoder/skills/)`);
+        }
+    }
+    catch (err) {
+        result.errors.push(`Qoder skills: ${err instanceof Error ? err.message : String(err)}`);
+    }
+}
 /**
  * Build a TOML section for Codex MCP config (~/.codex/config.toml).
  */
@@ -677,7 +838,12 @@ async function upsertCodexConfigToml(configPath) {
     try {
         existing = await fs.readFile(configPath, 'utf-8');
     }
-    catch {
+    catch (err) {
+        // TOML variant of the mergeJsoncFile contract: treating a non-ENOENT read
+        // failure as an empty config would rewrite config.toml with only the
+        // gitnexus section. Rethrow into setupCodex's catch.
+        if (!isEnoent(err))
+            throw err;
         existing = '';
     }
     if (existing.includes(`[${getEditorTargets().codex.tomlSection}]`)) {
@@ -885,12 +1051,16 @@ export const setupCommand = async (options) => {
         await setupAntigravity(result);
     if (selected.has('opencode'))
         await setupOpenCode(result);
+    if (selected.has('codebuddy'))
+        await setupCodeBuddy(result);
+    if (selected.has('qoder'))
+        await setupQoder(result);
     if (selected.has('codex'))
         await setupCodex(result);
     // Install global skills for platforms that support them
     if (selected.has('claude')) {
         await installClaudeCodeSkills(result);
-        await installClaudeCodeHooks(result);
+        await installClaudeSchemaHooks(result, 'claude');
     }
     if (selected.has('antigravity')) {
         await installAntigravitySkills(result);
@@ -900,8 +1070,14 @@ export const setupCommand = async (options) => {
         await installCursorSkills(result);
     if (selected.has('opencode'))
         await installOpenCodeSkills(result);
-    if (selected.has('codex'))
+    if (selected.has('codebuddy'))
+        await installCodeBuddySkills(result);
+    if (selected.has('qoder'))
+        await installQoderSkills(result);
+    if (selected.has('codex')) {
         await installCodexSkills(result);
+        await installClaudeSchemaHooks(result, 'codex');
+    }
     // Print results
     if (result.configured.length > 0) {
         console.log('  Configured:');