fix(installer): support npm-linked cli wrapper

Author: ndycode

CHANGELOG.md

@@ -10,6 +10,9 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 ### Added
 - (placeholder for next release)
 
+### Fixed
+- Local `npm link` installs now run the CLI wrapper correctly by resolving symlinked bin paths before direct-execution detection.
+
 ## [6.1.7] - 2026-04-25
 
 ### Added

scripts/install-oc-codex-multi-auth.js

@@ -1,12 +1,37 @@
 #!/usr/bin/env node
 
+import { realpathSync } from "node:fs";
 import { resolve } from "node:path";
 import { fileURLToPath } from "node:url";
 import { runInstaller } from "./install-oc-codex-multi-auth-core.js";
 
 export * from "./install-oc-codex-multi-auth-core.js";
 
-if (process.argv[1] && resolve(process.argv[1]) === fileURLToPath(import.meta.url)) {
+const __filename = fileURLToPath(import.meta.url);
+
+function normalizePathForCompare(path, resolveRealPath = realpathSync) {
+	const resolved = resolve(path);
+	try {
+		const realPath = resolveRealPath(resolved);
+		return process.platform === "win32" ? realPath.toLowerCase() : realPath;
+	} catch {
+		return process.platform === "win32" ? resolved.toLowerCase() : resolved;
+	}
+}
+
+export function isDirectRunPath(
+	argvPath = process.argv[1],
+	modulePath = __filename,
+	resolveRealPath = realpathSync,
+) {
+	if (!argvPath) return false;
+	return (
+		normalizePathForCompare(argvPath, resolveRealPath) ===
+		normalizePathForCompare(modulePath, resolveRealPath)
+	);
+}
+
+if (isDirectRunPath()) {
 	runInstaller().catch((error) => {
 		const message = error instanceof Error ? error.message : String(error);
 		console.error(`Installer failed: ${message}`);

test/install-oc-codex-multi-auth.test.ts

@@ -1,7 +1,7 @@
 import { afterEach, describe, expect, it, vi } from "vitest";
 import { mkdir, mkdtemp, readFile, readdir, rm, writeFile } from "node:fs/promises";
 import { tmpdir } from "node:os";
-import { join } from "node:path";
+import { join, resolve } from "node:path";
 
 type OpenAiTemplate = {
 	provider: {
@@ -42,6 +42,26 @@ describe("install-oc-codex-multi-auth script", () => {
 		expect(errorSpy).not.toHaveBeenCalled();
 	});
 
+	it("detects direct CLI execution after path normalization", async () => {
+		vi.resetModules();
+		const { isDirectRunPath } = await import("../scripts/install-oc-codex-multi-auth.js");
+		const scriptPath = resolve("scripts", "install-oc-codex-multi-auth.js");
+		const symlinkedScriptPath = join(
+			process.cwd(),
+			"global",
+			"node_modules",
+			"oc-codex-multi-auth",
+			"install-oc-codex-multi-auth.js",
+		);
+		const resolveRealPath = (path: string) => path === symlinkedScriptPath ? scriptPath : path;
+
+		expect(isDirectRunPath(symlinkedScriptPath, scriptPath, resolveRealPath)).toBe(true);
+		expect(
+			isDirectRunPath(resolve("scripts", "install-oc-codex-multi-auth-core.js"), scriptPath),
+		).toBe(false);
+		expect(isDirectRunPath(undefined, scriptPath)).toBe(false);
+	});
+
 	it("writes compact UI catalog by default, preserves user model entries, and normalizes plugin entries", async () => {
 		vi.resetModules();
 		tempHome = await createTempHome();