@wen2go/codex-auth-ext 0.3.0-alpha.7

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026-PRESENT Loongphy<https://github.com/loongphy>
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,150 @@
+# Codex Auth Ext
+
+![command list](https://github.com/user-attachments/assets/6c13a2d6-f9da-47ea-8ec8-0394fc072d40)
+
+`codex-auth` is a command-line tool for switching Codex accounts.
+
+## Fork Notice
+
+This repository is a second-development fork of [Loongphy/codex-auth](https://github.com/Loongphy/codex-auth).
+
+This fork adds:
+
+- Alias-first account labels in `codex-auth list`, so accounts with an alias render as `alias(email)`.
+- `codex-auth login --alias <alias>` for assigning an alias while adding a new account.
+- `codex-auth set-alias <selector> <alias>` as a shortcut for updating an existing account alias.
+- A local npm packaging helper, `npm run pack:local`, for building an installable package from the current platform binary.
+
+> [!IMPORTANT]
+> For **Codex CLI** and **Codex App** users, switch accounts, then restart the client for the new account to take effect.
+>
+> If you use the CLI and want seamless automatic account switching without restarting, use the forked [`codext`](https://github.com/Loongphy/codext), an enhanced Codex CLI. Install it with `npm i -g @loongphy/codext` and run `codext`.
+
+## Supported Platforms
+
+`codex-auth` works with these Codex clients:
+
+- Codex CLI
+- VS Code extension
+- Codex App
+
+For the best experience, install the Codex CLI even if you mainly use the VS Code extension or the App, because it makes adding accounts easier:
+
+```shell
+npm install -g @openai/codex
+```
+
+After that, you can use `codex login`, `codex login --device-auth`, `codex-auth login`, or `codex-auth login --device-auth` to sign in and add accounts more easily.
+
+## Install
+
+Install with npm:
+
+```shell
+npm install -g @wen2go/codex-auth-ext
+```
+
+  You can also run it without a global install:
+
+```shell
+npx @wen2go/codex-auth-ext list
+```
+
+  npm packages currently support Linux x64, Linux arm64, macOS x64, macOS arm64, Windows x64, and Windows arm64.
+
+### Uninstall
+
+#### npm
+
+Remove the npm package:
+
+```shell
+npm uninstall -g @wen2go/codex-auth-ext
+```
+
+## Commands
+
+Detailed command documentation lives in [docs/commands/README.md](./docs/commands/README.md).
+
+### Account Management
+
+| Command | Description |
+|---------|-------------|
+| [`codex-auth list [--live] [--active] [--api\|--skip-api]`](./docs/commands/list.md) | List stored accounts and usage state |
+| [`codex-auth login [--device-auth] [--alias <alias>]`](./docs/commands/login.md) | Run `codex login`, then add the current account |
+| [`codex-auth switch [--live] [--api\|--skip-api]`](./docs/commands/switch.md) | Switch the active account interactively |
+| [`codex-auth switch <query>`](./docs/commands/switch.md) | Switch directly by row number or account selector |
+| [`codex-auth remove [--live] [--api\|--skip-api]`](./docs/commands/remove.md) | Remove accounts interactively |
+| [`codex-auth remove <query> [<query>...]`](./docs/commands/remove.md) | Remove accounts by selector |
+| [`codex-auth remove --all`](./docs/commands/remove.md) | Remove all stored accounts |
+| [`codex-auth set-alias <query> <alias>`](./docs/commands/alias.md) | Set or update an account alias |
+
+### Import and Maintenance
+
+| Command | Description |
+|---------|-------------|
+| [`codex-auth import <path> [--alias <alias>]`](./docs/commands/import.md) | Import a single auth file or batch import a folder |
+| [`codex-auth import --cpa [<path>]`](./docs/commands/import.md) | Import CLIProxyAPI token JSON |
+| [`codex-auth import --purge [<path>]`](./docs/commands/import.md) | Rebuild `registry.json` from auth files |
+| [`codex-auth export [<dir>]`](./docs/commands/export.md) | Export stored account auth files |
+| [`codex-auth export --cpa [<dir>]`](./docs/commands/export.md) | Export CLIProxyAPI token JSON |
+| [`codex-auth clean`](./docs/commands/clean.md) | Delete managed backup and stale account files |
+
+### Configuration
+
+| Command | Description |
+|---------|-------------|
+| [`codex-auth config live --interval <seconds>`](./docs/commands/config.md) | Configure live TUI refresh interval |
+
+## Quick Examples
+
+```shell
+codex-auth list
+codex-auth list --active
+codex-auth switch
+codex-auth switch 02
+codex-auth remove work
+codex-auth login --alias personal
+codex-auth set-alias 02 work
+codex-auth import /path/to/auth.json --alias personal
+codex-auth list --skip-api
+```
+
+## Q&A
+
+### Why is my usage limit not refreshing?
+
+API-backed refresh is the default. When you pass `--skip-api`, `codex-auth` reads the newest `~/.codex/sessions/**/rollout-*.jsonl` file instead. Recent Codex builds often write `token_count` events with `rate_limits: null`. The local files may still contain older usable usage limit data, but in practice they can lag by several hours, so local-only refresh may show a usage limit snapshot from hours ago instead of your latest state.
+
+- Upstream Codex issue: [openai/codex#14880](https://github.com/openai/codex/issues/14880)
+
+Run the API-backed default with:
+
+```shell
+codex-auth list
+```
+
+Run one local-only command with:
+
+```shell
+codex-auth list --skip-api
+```
+
+Verify with:
+
+```shell
+codex exec "say hello"
+```
+
+## Disclaimer
+
+This project is provided as-is and use is at your own risk.
+
+**Usage Data Refresh Source:**
+`codex-auth` supports two sources for refreshing account usage/usage limit information:
+
+1. **API (default):** The tool makes direct HTTPS requests to OpenAI's endpoints using your account's access token. This enables both usage refresh and team name refresh. npm installs already satisfy the runtime requirement.
+2. **Local-only:** With per-command `--skip-api`, the tool scans local `~/.codex/sessions/*/rollout-*.jsonl` files for usage data and skips team name refresh API calls. This mode is safer, but it can be less accurate because recent Codex rollout files often contain `rate_limits: null`, so the latest local usage limit data may lag by several hours.
+
+**API Call Declaration:**
+By using the default API-backed refresh, this tool will send your ChatGPT access token to OpenAI's servers, including `https://chatgpt.com/backend-api/wham/usage` for usage limit and `https://chatgpt.com/backend-api/accounts/check/v4-2023-04-27` for team name. This behavior may be detected by OpenAI and could violate their terms of service, potentially leading to account suspension or other risks. The decision to use this feature and any resulting consequences are entirely yours.

package/bin/codex-auth.js

@@ -0,0 +1,111 @@
+#!/usr/bin/env node
+
+import { spawnSync } from "node:child_process";
+import fs from "node:fs";
+import { createRequire } from "node:module";
+import path from "node:path";
+import { fileURLToPath } from "node:url";
+
+const __filename = fileURLToPath(import.meta.url);
+const __dirname = path.dirname(__filename);
+const require = createRequire(import.meta.url);
+const rootPackageJsonPath = path.join(__dirname, "..", "package.json");
+const requiredNodeMajor = 22;
+
+function ensureSupportedNodeVersion() {
+  const major = Number(process.versions?.node?.split(".")[0] ?? 0);
+  if (Number.isInteger(major) && major >= requiredNodeMajor) {
+    return;
+  }
+
+  console.error(
+    `Node.js ${requiredNodeMajor}+ is required to run @wen2go/codex-auth-ext. Current version: ${process.version}.`
+  );
+  process.exit(1);
+}
+
+ensureSupportedNodeVersion();
+
+const packageMap = {
+  "linux:x64": "@wen2go/codex-auth-ext-linux-x64",
+  "linux:arm64": "@wen2go/codex-auth-ext-linux-arm64",
+  "darwin:x64": "@wen2go/codex-auth-ext-darwin-x64",
+  "darwin:arm64": "@wen2go/codex-auth-ext-darwin-arm64",
+  "win32:x64": "@wen2go/codex-auth-ext-win32-x64",
+  "win32:arm64": "@wen2go/codex-auth-ext-win32-arm64"
+};
+
+function readRootPackage() {
+  try {
+    return JSON.parse(fs.readFileSync(rootPackageJsonPath, "utf8"));
+  } catch {
+    return null;
+  }
+}
+
+function maybePrintPreviewVersion(argv) {
+  if (argv.length !== 1) return false;
+  if (argv[0] !== "--version" && argv[0] !== "-V") return false;
+
+  const rootPackage = readRootPackage();
+  if (!rootPackage) return false;
+
+  const previewLabel = rootPackage.codexAuthPreviewLabel;
+  if (typeof previewLabel !== "string" || previewLabel.length === 0) return false;
+  if (typeof rootPackage.version !== "string" || rootPackage.version.length === 0) return false;
+
+  process.stdout.write(`codex-auth ${rootPackage.version} (preview ${previewLabel})\n`);
+  return true;
+}
+
+if (maybePrintPreviewVersion(process.argv.slice(2))) {
+  process.exit(0);
+}
+
+function resolveBinary() {
+  const key = `${process.platform}:${process.arch}`;
+  const packageName = packageMap[key];
+  if (!packageName) {
+    console.error(`Unsupported platform: ${process.platform}/${process.arch}`);
+    process.exit(1);
+  }
+
+  try {
+    const packageRoot = path.dirname(require.resolve(`${packageName}/package.json`));
+    const binaryName = process.platform === "win32" ? "codex-auth.exe" : "codex-auth";
+    const binaryPath = path.join(packageRoot, "bin", binaryName);
+    if (!fs.existsSync(binaryPath)) {
+      console.error(`Missing binary inside ${packageName}: ${binaryPath}`);
+      process.exit(1);
+    }
+    return binaryPath;
+  } catch (error) {
+    console.error(
+      `Missing platform package ${packageName}. Reinstall @wen2go/codex-auth-ext on ${process.platform}/${process.arch}.`
+    );
+    if (error && error.message) {
+      console.error(error.message);
+    }
+    process.exit(1);
+  }
+}
+
+const binaryPath = resolveBinary();
+const child = spawnSync(binaryPath, process.argv.slice(2), {
+  stdio: "inherit",
+  env: {
+    ...process.env,
+    CODEX_AUTH_NODE_EXECUTABLE: process.execPath
+  }
+});
+
+if (child.error) {
+  console.error(child.error.message);
+  process.exit(1);
+}
+
+if (child.signal) {
+  process.kill(process.pid, child.signal);
+} else {
+  process.exit(child.status ?? 1);
+}

package/package.json

@@ -0,0 +1,43 @@
+{
+  "name": "@wen2go/codex-auth-ext",
+  "version": "0.3.0-alpha.7",
+  "type": "module",
+  "description": "CLI for switching Codex accounts",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/wen2go/codex-auth-ext.git"
+  },
+  "homepage": "https://github.com/wen2go/codex-auth-ext",
+  "bugs": {
+    "url": "https://github.com/wen2go/codex-auth-ext/issues"
+  },
+  "bin": {
+    "codex-auth": "bin/codex-auth.js"
+  },
+  "files": [
+    "bin/",
+    "LICENSE",
+    "README.md"
+  ],
+  "optionalDependencies": {
+    "@wen2go/codex-auth-ext-linux-x64": "0.3.0-alpha.7",
+    "@wen2go/codex-auth-ext-linux-arm64": "0.3.0-alpha.7",
+    "@wen2go/codex-auth-ext-darwin-x64": "0.3.0-alpha.7",
+    "@wen2go/codex-auth-ext-darwin-arm64": "0.3.0-alpha.7",
+    "@wen2go/codex-auth-ext-win32-x64": "0.3.0-alpha.7",
+    "@wen2go/codex-auth-ext-win32-arm64": "0.3.0-alpha.7"
+  },
+  "scripts": {
+    "check:versions": "node scripts/npm/check-versions.mjs",
+    "check:release-metadata": "node scripts/npm/check-release-metadata.mjs",
+    "pack:local": "node scripts/npm/stage-local-package.mjs",
+    "stage:npm": "node scripts/npm/stage-packages.mjs"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "engines": {
+    "node": ">=22"
+  }
+}