@imdeadpool/codex-account-switcher 0.1.6 → 0.1.8

package/README.md

@@ -19,6 +19,14 @@ Codex stores your authentication session in a single `auth.json` file. This tool
 npm i -g @imdeadpool/codex-account-switcher
 ```
 
+During global install, the package asks for permission to add an optional shell hook
+(`~/.bashrc` or `~/.zshrc`) that auto-runs a silent snapshot sync after successful
+official `codex login`.
+
+- Choose `y` to enable fully automatic login snapshot capture.
+- Choose `n` (default) to skip.
+- Set `CODEX_AUTH_SKIP_POSTINSTALL=1` to always suppress this prompt.
+
 ## Usage
 
 ```sh
@@ -37,7 +45,7 @@ codex-auth save <name>
 # force overwrite a name even when it currently maps to a different email
 codex-auth save <name> --force
 
-# switch active account (symlinks on macOS/Linux; copies on Windows)
+# switch active account
 codex-auth use <name>
 
 # or pick interactively
@@ -74,13 +82,18 @@ codex-auth config api disable
 # daemon runtime (internal/service use)
 codex-auth daemon --once
 codex-auth daemon --watch
+
+# optional shell hook helpers
+codex-auth setup-login-hook
+codex-auth hook-status
+codex-auth remove-login-hook
 ```
 
 ### Command reference
 
 - `codex-auth save <name> [--force]` – Validates `<name>`, ensures `auth.json` exists, then snapshots it to `~/.codex/accounts/<name>.json`. By default, it blocks overwriting a name when the existing snapshot email differs from current auth. If `name` is omitted, it first tries reusing the active snapshot name when identity matches; otherwise it infers one from auth email.
 - `codex-auth login [name] [--device-auth] [--force]` – Runs `codex login` (optionally with device auth), waits for refreshed auth snapshot detection, then saves it. If `name` is omitted, it always infers one from auth email with unique-suffix handling for multi-workspace identities.
-- `codex-auth use [name]` – Accepts a name or launches an interactive selector with the current account pre-selected. Copies on Windows, creates a symlink elsewhere, and records the active name.
+- `codex-auth use [name]` – Accepts a name or launches an interactive selector with the current account pre-selected, writes `~/.codex/auth.json` as a regular file from the chosen snapshot, and records the active name.
 - `codex-auth list [--details]` – Lists all saved snapshots alphabetically and marks the active one with `*`. `--details` adds per-snapshot mapping metadata (email, account id, user id, and usage metadata) for easier session/account troubleshooting.
 - `codex-auth current` – Prints the active account name, or a friendly message if none is active.
 - `codex-auth remove [query|--all]` – Removes snapshots interactively or by selector. If the active account is removed, the best remaining account is activated automatically.
@@ -88,6 +101,9 @@ codex-auth daemon --watch
 - `codex-auth config auto ...` – Enables/disables managed auto-switch and updates threshold percentages.
 - `codex-auth config api enable|disable` – Chooses usage source mode (`api` or `local`).
 - `codex-auth daemon --once|--watch` – Runs the auto-switch loop once or continuously.
+- `codex-auth setup-login-hook [-f <path>]` – Installs an optional shell hook in your rc file to auto-sync snapshots after successful official `codex login`.
+- `codex-auth hook-status [-f <path>]` – Shows whether the optional login auto-snapshot hook is installed for the selected rc file.
+- `codex-auth remove-login-hook [-f <path>]` – Removes the optional shell hook.
 
 ### Auto-switch behavior
 
@@ -113,5 +129,5 @@ Usage refresh is hybrid:
 
 Notes:
 
-- Works on macOS/Linux (symlink) and Windows (copy).
+- Works on macOS/Linux/Windows (regular-file auth snapshot activation).
 - Requires Node 18+.

package/dist/commands/hook-status.d.ts

@@ -0,0 +1,9 @@
+import { BaseCommand } from "../lib/base-command";
+export default class HookStatusCommand extends BaseCommand {
+    protected readonly syncExternalAuthBeforeRun = false;
+    static description: string;
+    static flags: {
+        readonly shellRc: import("@oclif/core/lib/interfaces").OptionFlag<string | undefined, import("@oclif/core/lib/interfaces").CustomOptions>;
+    };
+    run(): Promise<void>;
+}

package/dist/commands/hook-status.js

@@ -0,0 +1,30 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const core_1 = require("@oclif/core");
+const base_command_1 = require("../lib/base-command");
+const login_hook_1 = require("../lib/config/login-hook");
+class HookStatusCommand extends base_command_1.BaseCommand {
+    constructor() {
+        super(...arguments);
+        this.syncExternalAuthBeforeRun = false;
+    }
+    async run() {
+        await this.runSafe(async () => {
+            var _a;
+            const { flags } = await this.parse(HookStatusCommand);
+            const rcPath = (_a = flags.shellRc) !== null && _a !== void 0 ? _a : (0, login_hook_1.resolveDefaultShellRcPath)();
+            const status = await (0, login_hook_1.getLoginHookStatus)(rcPath);
+            this.log(`login-hook: ${status.installed ? "installed" : "not-installed"}`);
+            this.log(`rc-file: ${status.rcPath}`);
+        });
+    }
+}
+HookStatusCommand.description = "Show whether the login auto-snapshot shell hook is installed";
+HookStatusCommand.flags = {
+    shellRc: core_1.Flags.string({
+        char: "f",
+        description: "Explicit shell rc file path (defaults to ~/.bashrc or ~/.zshrc)",
+        required: false,
+    }),
+};
+exports.default = HookStatusCommand;

package/dist/commands/remove-login-hook.d.ts

@@ -0,0 +1,9 @@
+import { BaseCommand } from "../lib/base-command";
+export default class RemoveLoginHookCommand extends BaseCommand {
+    protected readonly syncExternalAuthBeforeRun = false;
+    static description: string;
+    static flags: {
+        readonly shellRc: import("@oclif/core/lib/interfaces").OptionFlag<string | undefined, import("@oclif/core/lib/interfaces").CustomOptions>;
+    };
+    run(): Promise<void>;
+}

package/dist/commands/remove-login-hook.js

@@ -0,0 +1,35 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const core_1 = require("@oclif/core");
+const base_command_1 = require("../lib/base-command");
+const login_hook_1 = require("../lib/config/login-hook");
+class RemoveLoginHookCommand extends base_command_1.BaseCommand {
+    constructor() {
+        super(...arguments);
+        this.syncExternalAuthBeforeRun = false;
+    }
+    async run() {
+        await this.runSafe(async () => {
+            var _a;
+            const { flags } = await this.parse(RemoveLoginHookCommand);
+            const rcPath = (_a = flags.shellRc) !== null && _a !== void 0 ? _a : (0, login_hook_1.resolveDefaultShellRcPath)();
+            const result = await (0, login_hook_1.removeLoginHook)(rcPath);
+            if (result === "not-installed") {
+                this.log(`No login auto-snapshot hook found in ${rcPath}.`);
+            }
+            else {
+                this.log(`Removed login auto-snapshot hook from ${rcPath}.`);
+            }
+            this.log(`Reload your shell: source ${rcPath}`);
+        });
+    }
+}
+RemoveLoginHookCommand.description = "Remove the shell hook that auto-syncs snapshots after `codex login`";
+RemoveLoginHookCommand.flags = {
+    shellRc: core_1.Flags.string({
+        char: "f",
+        description: "Explicit shell rc file path (defaults to ~/.bashrc or ~/.zshrc)",
+        required: false,
+    }),
+};
+exports.default = RemoveLoginHookCommand;

package/dist/commands/setup-login-hook.d.ts

@@ -0,0 +1,9 @@
+import { BaseCommand } from "../lib/base-command";
+export default class SetupLoginHookCommand extends BaseCommand {
+    protected readonly syncExternalAuthBeforeRun = false;
+    static description: string;
+    static flags: {
+        readonly shellRc: import("@oclif/core/lib/interfaces").OptionFlag<string | undefined, import("@oclif/core/lib/interfaces").CustomOptions>;
+    };
+    run(): Promise<void>;
+}

package/dist/commands/setup-login-hook.js

@@ -0,0 +1,35 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const core_1 = require("@oclif/core");
+const base_command_1 = require("../lib/base-command");
+const login_hook_1 = require("../lib/config/login-hook");
+class SetupLoginHookCommand extends base_command_1.BaseCommand {
+    constructor() {
+        super(...arguments);
+        this.syncExternalAuthBeforeRun = false;
+    }
+    async run() {
+        await this.runSafe(async () => {
+            var _a;
+            const { flags } = await this.parse(SetupLoginHookCommand);
+            const rcPath = (_a = flags.shellRc) !== null && _a !== void 0 ? _a : (0, login_hook_1.resolveDefaultShellRcPath)();
+            const result = await (0, login_hook_1.installLoginHook)(rcPath);
+            if (result === "already-installed") {
+                this.log(`Login auto-snapshot hook is already installed in ${rcPath}.`);
+            }
+            else {
+                this.log(`Installed login auto-snapshot hook in ${rcPath}.`);
+            }
+            this.log(`Reload your shell: source ${rcPath}`);
+        });
+    }
+}
+SetupLoginHookCommand.description = "Install a shell hook that auto-syncs snapshots after successful `codex login`";
+SetupLoginHookCommand.flags = {
+    shellRc: core_1.Flags.string({
+        char: "f",
+        description: "Explicit shell rc file path (defaults to ~/.bashrc or ~/.zshrc)",
+        required: false,
+    }),
+};
+exports.default = SetupLoginHookCommand;

package/dist/lib/config/login-hook.d.ts

@@ -0,0 +1,13 @@
+export declare const LOGIN_HOOK_MARK_START = "# >>> codex-auth-login-auto-snapshot >>>";
+export declare const LOGIN_HOOK_MARK_END = "# <<< codex-auth-login-auto-snapshot <<<";
+export type HookInstallStatus = "installed" | "already-installed";
+export type HookRemoveStatus = "removed" | "not-installed";
+export interface LoginHookStatus {
+    installed: boolean;
+    rcPath: string;
+}
+export declare function resolveDefaultShellRcPath(): string;
+export declare function renderLoginHookBlock(): string;
+export declare function installLoginHook(rcPath?: string): Promise<HookInstallStatus>;
+export declare function removeLoginHook(rcPath?: string): Promise<HookRemoveStatus>;
+export declare function getLoginHookStatus(rcPath?: string): Promise<LoginHookStatus>;

package/dist/lib/config/login-hook.js

@@ -0,0 +1,119 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.LOGIN_HOOK_MARK_END = exports.LOGIN_HOOK_MARK_START = void 0;
+exports.resolveDefaultShellRcPath = resolveDefaultShellRcPath;
+exports.renderLoginHookBlock = renderLoginHookBlock;
+exports.installLoginHook = installLoginHook;
+exports.removeLoginHook = removeLoginHook;
+exports.getLoginHookStatus = getLoginHookStatus;
+const promises_1 = __importDefault(require("node:fs/promises"));
+const node_os_1 = __importDefault(require("node:os"));
+const node_path_1 = __importDefault(require("node:path"));
+exports.LOGIN_HOOK_MARK_START = "# >>> codex-auth-login-auto-snapshot >>>";
+exports.LOGIN_HOOK_MARK_END = "# <<< codex-auth-login-auto-snapshot <<<";
+function escapeRegex(input) {
+    return input.replace(/[.*+?^${}()|[\]\\]/g, "\\$&");
+}
+function hookBlockRegex() {
+    const start = escapeRegex(exports.LOGIN_HOOK_MARK_START);
+    const end = escapeRegex(exports.LOGIN_HOOK_MARK_END);
+    return new RegExp(`\\n?${start}[\\s\\S]*?${end}\\n?`, "g");
+}
+function resolveDefaultShellRcPath() {
+    var _a;
+    const shell = ((_a = process.env.SHELL) !== null && _a !== void 0 ? _a : "").toLowerCase();
+    if (shell.includes("zsh")) {
+        return node_path_1.default.join(node_os_1.default.homedir(), ".zshrc");
+    }
+    return node_path_1.default.join(node_os_1.default.homedir(), ".bashrc");
+}
+function renderLoginHookBlock() {
+    return [
+        exports.LOGIN_HOOK_MARK_START,
+        "# Auto-sync codex-auth snapshots after successful official `codex login`.",
+        "if ! typeset -f codex >/dev/null 2>&1; then",
+        "  codex() {",
+        "    command codex \"$@\"",
+        "    local __codex_exit=$?",
+        "    if [[ $__codex_exit -eq 0 ]]; then",
+        "      local __first_non_flag=\"\"",
+        "      local __arg",
+        "      for __arg in \"$@\"; do",
+        "        case \"$__arg\" in",
+        "          --) break ;;",
+        "          -*) ;;",
+        "          *) __first_non_flag=\"$__arg\"; break ;;",
+        "        esac",
+        "      done",
+        "      if [[ \"$__first_non_flag\" == \"login\" ]] && command -v codex-auth >/dev/null 2>&1; then",
+        "        command codex-auth status >/dev/null 2>&1 || true",
+        "      fi",
+        "    fi",
+        "    return $__codex_exit",
+        "  }",
+        "fi",
+        exports.LOGIN_HOOK_MARK_END,
+    ].join("\n");
+}
+async function installLoginHook(rcPath = resolveDefaultShellRcPath()) {
+    await promises_1.default.mkdir(node_path_1.default.dirname(rcPath), { recursive: true });
+    let existing = "";
+    try {
+        existing = await promises_1.default.readFile(rcPath, "utf8");
+    }
+    catch (error) {
+        const err = error;
+        if (err.code !== "ENOENT")
+            throw error;
+    }
+    if (existing.includes(exports.LOGIN_HOOK_MARK_START) && existing.includes(exports.LOGIN_HOOK_MARK_END)) {
+        return "already-installed";
+    }
+    const next = `${existing.replace(/\s*$/, "")}\n\n${renderLoginHookBlock()}\n`;
+    await promises_1.default.writeFile(rcPath, next, "utf8");
+    return "installed";
+}
+async function removeLoginHook(rcPath = resolveDefaultShellRcPath()) {
+    let existing = "";
+    try {
+        existing = await promises_1.default.readFile(rcPath, "utf8");
+    }
+    catch (error) {
+        const err = error;
+        if (err.code === "ENOENT") {
+            return "not-installed";
+        }
+        throw error;
+    }
+    const regex = hookBlockRegex();
+    const stripped = existing.replace(regex, "\n");
+    if (stripped === existing) {
+        return "not-installed";
+    }
+    await promises_1.default.writeFile(rcPath, stripped.replace(/\n{3,}/g, "\n\n"), "utf8");
+    return "removed";
+}
+async function getLoginHookStatus(rcPath = resolveDefaultShellRcPath()) {
+    let existing = "";
+    try {
+        existing = await promises_1.default.readFile(rcPath, "utf8");
+    }
+    catch (error) {
+        const err = error;
+        if (err.code === "ENOENT") {
+            return {
+                installed: false,
+                rcPath,
+            };
+        }
+        throw error;
+    }
+    const installed = existing.includes(exports.LOGIN_HOOK_MARK_START) && existing.includes(exports.LOGIN_HOOK_MARK_END);
+    return {
+        installed,
+        rcPath,
+    };
+}

package/dist/tests/login-hook.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/tests/login-hook.test.js

@@ -0,0 +1,67 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+const node_test_1 = __importDefault(require("node:test"));
+const strict_1 = __importDefault(require("node:assert/strict"));
+const node_os_1 = __importDefault(require("node:os"));
+const node_path_1 = __importDefault(require("node:path"));
+const promises_1 = __importDefault(require("node:fs/promises"));
+const login_hook_1 = require("../lib/config/login-hook");
+async function withTempRcFile(t, fn) {
+    const tempDir = await promises_1.default.mkdtemp(node_path_1.default.join(node_os_1.default.tmpdir(), "codex-auth-hook-"));
+    const rcPath = node_path_1.default.join(tempDir, ".bashrc");
+    await promises_1.default.writeFile(rcPath, "# test bashrc\n", "utf8");
+    t.after(async () => {
+        await promises_1.default.rm(tempDir, { recursive: true, force: true });
+    });
+    await fn(rcPath);
+}
+(0, node_test_1.default)("installLoginHook writes marker block when missing", async (t) => {
+    await withTempRcFile(t, async (rcPath) => {
+        const result = await (0, login_hook_1.installLoginHook)(rcPath);
+        strict_1.default.equal(result, "installed");
+        const contents = await promises_1.default.readFile(rcPath, "utf8");
+        strict_1.default.ok(contents.includes(login_hook_1.LOGIN_HOOK_MARK_START));
+        strict_1.default.ok(contents.includes(login_hook_1.LOGIN_HOOK_MARK_END));
+    });
+});
+(0, node_test_1.default)("installLoginHook is idempotent", async (t) => {
+    await withTempRcFile(t, async (rcPath) => {
+        const first = await (0, login_hook_1.installLoginHook)(rcPath);
+        const second = await (0, login_hook_1.installLoginHook)(rcPath);
+        strict_1.default.equal(first, "installed");
+        strict_1.default.equal(second, "already-installed");
+        const contents = await promises_1.default.readFile(rcPath, "utf8");
+        const startCount = contents.split(login_hook_1.LOGIN_HOOK_MARK_START).length - 1;
+        strict_1.default.equal(startCount, 1);
+    });
+});
+(0, node_test_1.default)("removeLoginHook removes installed marker block", async (t) => {
+    await withTempRcFile(t, async (rcPath) => {
+        await (0, login_hook_1.installLoginHook)(rcPath);
+        const result = await (0, login_hook_1.removeLoginHook)(rcPath);
+        strict_1.default.equal(result, "removed");
+        const contents = await promises_1.default.readFile(rcPath, "utf8");
+        strict_1.default.ok(!contents.includes(login_hook_1.LOGIN_HOOK_MARK_START));
+        strict_1.default.ok(!contents.includes(login_hook_1.LOGIN_HOOK_MARK_END));
+    });
+});
+(0, node_test_1.default)("removeLoginHook returns not-installed when hook is absent", async (t) => {
+    await withTempRcFile(t, async (rcPath) => {
+        const result = await (0, login_hook_1.removeLoginHook)(rcPath);
+        strict_1.default.equal(result, "not-installed");
+    });
+});
+(0, node_test_1.default)("getLoginHookStatus reflects installed state", async (t) => {
+    await withTempRcFile(t, async (rcPath) => {
+        const before = await (0, login_hook_1.getLoginHookStatus)(rcPath);
+        strict_1.default.equal(before.installed, false);
+        strict_1.default.equal(before.rcPath, rcPath);
+        await (0, login_hook_1.installLoginHook)(rcPath);
+        const after = await (0, login_hook_1.getLoginHookStatus)(rcPath);
+        strict_1.default.equal(after.installed, true);
+        strict_1.default.equal(after.rcPath, rcPath);
+    });
+});

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@imdeadpool/codex-account-switcher",
-  "version": "0.1.6",
+  "version": "0.1.8",
   "description": "A command-line tool that lets you manage and switch between multiple Codex accounts instantly, no more constant logins and logouts.",
   "license": "MIT",
   "bin": {
@@ -10,6 +10,7 @@
   "types": "dist/index.d.ts",
   "scripts": {
     "build": "tsc -p tsconfig.json",
+    "postinstall": "node scripts/postinstall-login-hook.cjs",
     "prepublishOnly": "npm run build",
     "test": "npm run build && node --test dist/tests/**/*.test.js"
   },
@@ -18,6 +19,7 @@
   },
   "files": [
     "dist",
+    "scripts/postinstall-login-hook.cjs",
     "README.md",
     "LICENSE"
   ],
@@ -32,12 +34,12 @@
   "preferGlobal": true,
   "repository": {
     "type": "git",
-    "url": "git+https://github.com/NagyVikt/codex-account-switcher.git"
+    "url": "git+https://github.com/recodeecom/codex-account-switcher-cli.git"
   },
   "bugs": {
-    "url": "https://github.com/NagyVikt/codex-account-switcher/issues"
+    "url": "https://github.com/recodeecom/codex-account-switcher-cli/issues"
   },
-  "homepage": "https://github.com/NagyVikt/codex-account-switcher#readme",
+  "homepage": "https://github.com/recodeecom/codex-account-switcher-cli#readme",
   "author": "NagyVikt",
   "dependencies": {
     "@oclif/core": "^3.0.0",

package/scripts/postinstall-login-hook.cjs

@@ -0,0 +1,90 @@
+#!/usr/bin/env node
+
+const fs = require("node:fs/promises");
+const os = require("node:os");
+const path = require("node:path");
+const readline = require("node:readline/promises");
+
+const MARK_START = "# >>> codex-auth-login-auto-snapshot >>>";
+const MARK_END = "# <<< codex-auth-login-auto-snapshot <<<";
+
+function isTruthy(value) {
+  return typeof value === "string" && /^(1|true|yes|on)$/i.test(value.trim());
+}
+
+function targetShellRc() {
+  const shell = (process.env.SHELL || "").toLowerCase();
+  if (shell.includes("zsh")) return path.join(os.homedir(), ".zshrc");
+  return path.join(os.homedir(), ".bashrc");
+}
+
+function renderHookBlock() {
+  return [
+    MARK_START,
+    "# Auto-sync codex-auth snapshots after successful official `codex login`.",
+    "if ! typeset -f codex >/dev/null 2>&1; then",
+    "  codex() {",
+    "    command codex \"$@\"",
+    "    local __codex_exit=$?",
+    "    if [[ $__codex_exit -eq 0 ]]; then",
+    "      local __first_non_flag=\"\"",
+    "      local __arg",
+    "      for __arg in \"$@\"; do",
+    "        case \"$__arg\" in",
+    "          --) break ;;",
+    "          -*) ;;",
+    "          *) __first_non_flag=\"$__arg\"; break ;;",
+    "        esac",
+    "      done",
+    "      if [[ \"$__first_non_flag\" == \"login\" ]] && command -v codex-auth >/dev/null 2>&1; then",
+    "        command codex-auth status >/dev/null 2>&1 || true",
+    "      fi",
+    "    fi",
+    "    return $__codex_exit",
+    "  }",
+    "fi",
+    MARK_END,
+  ].join("\n");
+}
+
+async function maybeInstallHook() {
+  if (process.env.npm_config_global !== "true") return;
+  if (isTruthy(process.env.CODEX_AUTH_SKIP_POSTINSTALL)) return;
+  if (isTruthy(process.env.CI)) return;
+  if (!process.stdin.isTTY || !process.stdout.isTTY) return;
+
+  const rcPath = targetShellRc();
+  await fs.mkdir(path.dirname(rcPath), { recursive: true });
+
+  let rc = "";
+  try {
+    rc = await fs.readFile(rcPath, "utf8");
+  } catch (error) {
+    if (error && error.code !== "ENOENT") throw error;
+  }
+
+  if (rc.includes(MARK_START) && rc.includes(MARK_END)) return;
+
+  const rl = readline.createInterface({
+    input: process.stdin,
+    output: process.stdout,
+  });
+
+  try {
+    const answer = await rl.question(
+      `Install optional codex login auto-snapshot hook in ${rcPath}? [y/N] `,
+    );
+    if (!/^(y|yes)$/i.test((answer || "").trim())) return;
+  } finally {
+    rl.close();
+  }
+
+  const next = `${rc.replace(/\s*$/, "")}\n\n${renderHookBlock()}\n`;
+  await fs.writeFile(rcPath, next, "utf8");
+  process.stdout.write(`\nInstalled shell hook in ${rcPath}. Restart terminal or run: source ${rcPath}\n`);
+}
+
+maybeInstallHook().catch((error) => {
+  const message = error instanceof Error ? error.message : String(error);
+  process.stderr.write(`\n[codex-auth postinstall] Failed to install login hook: ${message}\n`);
+});