@loongphy/codex-auth 0.2.3 → 0.2.5

package/README.md

@@ -47,7 +47,22 @@ npx @loongphy/codex-auth list
 > If you previously used those legacy installers, remove the leftover binaries and profile changes during migration.
 > API-backed usage refresh and team-name refresh use Node.js `fetch`.
 > npm installs already satisfy that requirement.
-> Legacy standalone binary installs need Node.js 18+ on `PATH` when `codex-auth config api enable` is used.
+> Legacy standalone binary installs need Node.js 22+ on `PATH` when `codex-auth config api enable` is used.
+
+## Storage Root
+
+`codex-auth` uses the same Codex state root as the current process. Resolution order:
+
+1. `CODEX_HOME` when set to a non-empty existing directory
+2. `HOME/.codex`
+3. `USERPROFILE/.codex` on Windows
+
+When `CODEX_HOME` is set, `codex-auth` follows Codex and requires that directory to already exist.
+That means you can isolate auth, registry, config, and session files by running:
+
+```shell
+CODEX_HOME=/path/to/custom-codex codex-auth list
+```
 
 ### Uninstall
 
@@ -95,7 +110,7 @@ Remove-Item "$env:LOCALAPPDATA\codex-auth\bin\codex-auth-auto.exe" -Force -Error
 
 | Command | Description |
 |---------|-------------|
-| `codex-auth list` | List all accounts |
+| `codex-auth list [--debug]` | List all accounts |
 | `codex-auth login [--device-auth]` | Run `codex login` (optionally with `--device-auth`), then add the current account |
 | `codex-auth switch [<email>]` | Switch active account interactively or by partial match |
 | `codex-auth remove` | Remove accounts with interactive multi-select |
@@ -113,8 +128,8 @@ Remove-Item "$env:LOCALAPPDATA\codex-auth\bin\codex-auth-auto.exe" -Force -Error
 
 | Command | Description |
 |---------|-------------|
-| `codex-auth config auto enable\|disable` | Enable or disable background auto-switching |
-| `codex-auth config auto [--5h <%>] [--weekly <%>]` | Set auto-switch thresholds |
+| `codex-auth config auto enable\|disable` | Enable or disable experimental background auto-switching |
+| `codex-auth config auto [--5h <%>] [--weekly <%>]` | Set experimental auto-switch thresholds |
 | `codex-auth config api enable\|disable` | Enable or disable both usage refresh and team name refresh API calls |
 
 ---
@@ -125,6 +140,7 @@ Remove-Item "$env:LOCALAPPDATA\codex-auth\bin\codex-auth-auto.exe" -Force -Error
 
 ```shell
 codex-auth list
+codex-auth list --debug
 ```
 
 ### Switch Account
@@ -135,8 +151,6 @@ Interactive: shows email, 5h, weekly, and last activity.
 codex-auth switch
 ```
 
-Before the picker opens, the current active account's usage is refreshed once so the selected row is not stale. The newly selected account is not refreshed after the switch completes.
-
 ![command switch](https://github.com/user-attachments/assets/48a86acf-2a6e-4206-a8c4-591989fdc0df)
 
 Non-interactive: fuzzy match by email or alias.
@@ -223,6 +237,9 @@ codex-auth status
 
 #### Auto-Switch
 
+> [!WARNING]
+> Auto-switch is experimental. Behavior, defaults, and platform integration may change in future releases while the feature matures.
+
 Enable or disable:
 
 ```shell
@@ -307,7 +324,7 @@ 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):** When `config api enable` is on, 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.
+1. **API (default):** When `config api enable` is on, 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; legacy standalone binary installs need Node.js 22+ on `PATH`.
 2. **Local-only:** When `config api disable` is on, 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:**

package/bin/codex-auth.js

@@ -4,6 +4,21 @@ const path = require("node:path");
 const { spawnSync } = require("node:child_process");
 const fs = require("node:fs");
 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 @loongphy/codex-auth. Current version: ${process.version}.`
+  );
+  process.exit(1);
+}
+
+ensureSupportedNodeVersion();
 
 const packageMap = {
   "linux:x64": "@loongphy/codex-auth-linux-x64",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@loongphy/codex-auth",
-  "version": "0.2.3",
+  "version": "0.2.5",
   "description": "CLI for switching Codex accounts",
   "license": "MIT",
   "repository": {
@@ -20,12 +20,12 @@
     "README.md"
   ],
   "optionalDependencies": {
-    "@loongphy/codex-auth-linux-x64": "0.2.3",
-    "@loongphy/codex-auth-linux-arm64": "0.2.3",
-    "@loongphy/codex-auth-darwin-x64": "0.2.3",
-    "@loongphy/codex-auth-darwin-arm64": "0.2.3",
-    "@loongphy/codex-auth-win32-x64": "0.2.3",
-    "@loongphy/codex-auth-win32-arm64": "0.2.3"
+    "@loongphy/codex-auth-linux-x64": "0.2.5",
+    "@loongphy/codex-auth-linux-arm64": "0.2.5",
+    "@loongphy/codex-auth-darwin-x64": "0.2.5",
+    "@loongphy/codex-auth-darwin-arm64": "0.2.5",
+    "@loongphy/codex-auth-win32-x64": "0.2.5",
+    "@loongphy/codex-auth-win32-arm64": "0.2.5"
   },
   "scripts": {
     "check:versions": "node scripts/npm/check-versions.mjs",
@@ -35,6 +35,6 @@
     "access": "public"
   },
   "engines": {
-    "node": ">=18"
+    "node": ">=22"
   }
 }