@imdeadpool/codex-account-switcher 0.1.7 → 0.1.8

package/README.md

@@ -82,6 +82,11 @@ 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
@@ -96,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
 

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.7",
+  "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": {