@loongphy/codex-auth 0.2.6 → 0.3.0-alpha.1

package/README.md

@@ -94,10 +94,13 @@ Remove-Item "$env:LOCALAPPDATA\codex-auth\bin\codex-auth-auto.exe" -Force -Error
 
 | Command | Description |
 |---------|-------------|
-| `codex-auth list [--debug]` | List all accounts |
+| `codex-auth list [--live] [--api\|--skip-api]` | List all accounts. `--live` keeps refreshing the terminal view; `--api` forces remote refresh, while `--skip-api` forbids remote API use for this command. |
 | `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 |
+| `codex-auth switch [--live] [--auto] [--api\|--skip-api]` | Switch the active account interactively. Without `--live` it exits after one switch; with `--live` it stays open and keeps refreshing. `--auto` requires `--live` and auto-switches away from the current account when the live view shows it as exhausted or returns a non-200 usage API status. |
+| `codex-auth switch <query>` | Switch the active account directly by row number, alias, or fuzzy match using stored local data only. |
+| `codex-auth remove [--live] [--api\|--skip-api]` | Interactive remove. `--live` keeps the picker open after each deletion; `--api` forces remote refresh and `--skip-api` forbids remote API use for this command. |
+| `codex-auth remove <query> [<query>...]` | Remove one or more accounts by row number, alias, email, account name, or `account_key` match using stored local data. |
+| `codex-auth remove --all` | Remove all stored accounts. |
 | `codex-auth status` | Show auto-switch, service, and usage status |
 
 ### Import
@@ -126,35 +129,96 @@ Remove-Item "$env:LOCALAPPDATA\codex-auth\bin\codex-auth-auto.exe" -Force -Error
 
 ```shell
 codex-auth list
-codex-auth list --debug
+codex-auth list --live
+codex-auth list --api        # force usage/team-name API refresh, even if config api is disabled
+codex-auth list --skip-api   # forbid usage/team-name API refresh for this command
 ```
 
-### Switch Account
+`--live` keeps the list refreshing inside the terminal UI.
+`--api` forces the foreground usage and team-name refresh path for this command only.
+`--skip-api` forbids remote refresh for this command only. Usage can still refresh locally for the active account when local rollout data exists.
 
-Interactive: shows email, 5h, weekly, and last activity.
+### Switch Account
 
 ```shell
 codex-auth switch
+codex-auth switch --live
+codex-auth switch --live --auto
+codex-auth switch --api
+codex-auth switch --skip-api
 ```
 
-![command switch](https://github.com/user-attachments/assets/48a86acf-2a6e-4206-a8c4-591989fdc0df)
+`codex-auth switch`
+Opens the interactive picker. It shows email, 5h, weekly, and last activity, then exits after one successful switch.
+
+`codex-auth switch --live`
+Keeps the picker open after Enter, keeps refreshing the terminal view, and updates the footer with the latest switch result.
+
+`codex-auth switch --live --auto`
+Keeps watching the current live display and auto-switches only when the active account reaches `0%` on 5h or weekly, or when the usage API returns a non-200 status for the active account.
+
+`codex-auth switch --api`
+Forces a foreground remote refresh before opening the picker.
 
-Non-interactive: fuzzy match by email or alias.
+`codex-auth switch --skip-api`
+Forbids remote API use for this command and relies on local-only usage refresh where available.
+
+`codex-auth switch <query>`
+Switches directly by displayed row number, alias, or fuzzy email/alias match using stored local data only. The row number follows the interactive `switch` list, and the same number from `codex-auth list` also works because both commands use the same ordering. `switch <query>` does not accept `--live`, `--auto`, `--api`, or `--skip-api`.
+
+When `--live --auto` is active, auto-switch candidates still follow the live picker rules and skip accounts whose current 5h or weekly value is already `0%`.
+
+![command switch](https://github.com/user-attachments/assets/48a86acf-2a6e-4206-a8c4-591989fdc0df)
 
 ```shell
-codex-auth switch john             # match any account containing "john"
-codex-auth switch john@gmail.com   # match by full or partial email
-codex-auth switch work             # match by alias set during import
+codex-auth switch 02                 # switch by displayed row number
+codex-auth switch john               # fuzzy match by email or alias
+codex-auth switch work               # match by alias set during import
 ```
 
-If the keyword matches multiple accounts, the command falls back to interactive selection. Press `q` to quit without switching.
+If `<query>` matches multiple accounts, the command falls back to interactive selection. Press `q` to quit without switching.
 
 ### Remove Accounts
 
 ```shell
 codex-auth remove
+codex-auth remove --live
+codex-auth remove --api
+codex-auth remove --skip-api
 ```
 
+`codex-auth remove`
+Opens the interactive remove picker. It stays local-only by default so deletion is not blocked by API refresh work.
+
+`codex-auth remove --live`
+Keeps the picker open after each deletion so you can continue cleaning up accounts in one session.
+
+`codex-auth remove --api`
+Attempts a best-effort foreground refresh for picker display. Successful rows show live API data when it is available; rows that cannot refresh may show live error overlays such as `403`, `TimedOut`, or `MissingAuth` instead.
+
+`codex-auth remove --skip-api`
+Keeps the picker local-only explicitly and forbids remote API use for this command.
+
+`codex-auth remove <query> [<query>...]`
+Removes one or more accounts by row number, alias, email, account name, or `account_key` match using stored local data only.
+
+`codex-auth remove --all`
+Removes all stored accounts.
+
+Each selector supports the same query forms as `switch`: row number, alias, or fuzzy email/alias match.
+The row number follows the interactive `switch` list, and the same number from `codex-auth list` also works because both commands use the same ordering.
+You can pass multiple selectors in one command.
+Selector-based `remove` and `remove --all` do not accept `--live`, `--api`, or `--skip-api`.
+
+```shell
+codex-auth remove 01 03
+codex-auth remove work personal
+codex-auth remove 01 jane@example.com
+codex-auth remove --all
+```
+
+If any selector matches multiple accounts, `remove` asks for confirmation in interactive terminals before deleting.
+
 ### Login (Add Account)
 
 Add the currently logged-in Codex account:
@@ -240,6 +304,8 @@ When auto-switching is enabled, a long-running background watcher refreshes the
 - 5h remaining reaches `0`, or
 - weekly remaining reaches `0`
 
+Auto-switch evaluates both 5h and weekly by default, without separate threshold configuration.
+Candidates whose current 5h or weekly value is already `0` are skipped.
 When choosing the next account, `codex-auth` prefers a usable account whose remaining quota resets sooner, so a reset at `05:11` wins over `05:30`.
 
 The managed background worker is long-running on all supported platforms:

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@loongphy/codex-auth",
-  "version": "0.2.6",
+  "version": "0.3.0-alpha.1",
   "type": "module",
   "description": "CLI for switching Codex accounts",
   "license": "MIT",
@@ -21,12 +21,12 @@
     "README.md"
   ],
   "optionalDependencies": {
-    "@loongphy/codex-auth-linux-x64": "0.2.6",
-    "@loongphy/codex-auth-linux-arm64": "0.2.6",
-    "@loongphy/codex-auth-darwin-x64": "0.2.6",
-    "@loongphy/codex-auth-darwin-arm64": "0.2.6",
-    "@loongphy/codex-auth-win32-x64": "0.2.6",
-    "@loongphy/codex-auth-win32-arm64": "0.2.6"
+    "@loongphy/codex-auth-linux-x64": "0.3.0-alpha.1",
+    "@loongphy/codex-auth-linux-arm64": "0.3.0-alpha.1",
+    "@loongphy/codex-auth-darwin-x64": "0.3.0-alpha.1",
+    "@loongphy/codex-auth-darwin-arm64": "0.3.0-alpha.1",
+    "@loongphy/codex-auth-win32-x64": "0.3.0-alpha.1",
+    "@loongphy/codex-auth-win32-arm64": "0.3.0-alpha.1"
   },
   "scripts": {
     "check:versions": "node scripts/npm/check-versions.mjs",