codex-team 0.0.1 → 0.0.3

package/README.md

@@ -16,14 +16,14 @@ After install, use the `codexm` command.
 
 ```bash
 codexm current
-codexm list
+codexm list [name]
 codexm save <name>
 codexm update
 codexm switch <name>
+codexm switch --auto --dry-run
 codexm remove <name> --yes
 codexm rename <old> <new>
 codexm quota refresh [name]
-codexm quota list
 codexm doctor
 ```
 
@@ -34,8 +34,8 @@ Use `--json` on query and mutation commands when you need machine-readable outpu
 1. Log into a target account with the native Codex CLI.
 2. Save the current auth snapshot with `codexm save <name>`.
 3. Repeat for other accounts.
-4. Switch between saved accounts with `codexm switch <name>`.
-5. Refresh and inspect quota usage with `codexm quota refresh` and `codexm quota list`.
+4. Switch between saved accounts with `codexm switch <name>` or let the tool choose with `codexm switch --auto`.
+5. Refresh and inspect quota usage with `codexm list` or `codexm quota refresh`.
 
 ## Development
 

package/dist/cli.cjs

@@ -409,6 +409,7 @@ var __webpack_modules__ = {
         const FILE_MODE = 384;
         const SCHEMA_VERSION = 1;
         const ACCOUNT_NAME_PATTERN = /^[A-Za-z0-9][A-Za-z0-9._-]{0,63}$/;
+        const QUOTA_REFRESH_CONCURRENCY = 3;
         function defaultPaths(homeDir = (0, external_node_os_namespaceObject.homedir)()) {
             const codexDir = (0, external_node_path_namespaceObject.join)(homeDir, ".codex");
             const codexTeamDir = (0, external_node_path_namespaceObject.join)(homeDir, ".codex-team");
@@ -759,17 +760,36 @@ var __webpack_modules__ = {
                 const { accounts } = await this.listAccounts();
                 const targets = targetName ? accounts.filter((account)=>account.name === targetName) : accounts;
                 if (targetName && 0 === targets.length) throw new Error(`Account "${targetName}" does not exist.`);
+                const results = new Array(targets.length);
+                let nextIndex = 0;
+                const workerCount = Math.min(QUOTA_REFRESH_CONCURRENCY, targets.length);
+                await Promise.all(Array.from({
+                    length: workerCount
+                }, async ()=>{
+                    while(true){
+                        const index = nextIndex;
+                        nextIndex += 1;
+                        if (index >= targets.length) return;
+                        const account = targets[index];
+                        try {
+                            const refreshed = await this.refreshQuotaForAccount(account.name);
+                            results[index] = {
+                                success: await this.quotaSummaryForAccount(refreshed.account)
+                            };
+                        } catch (error) {
+                            results[index] = {
+                                failure: {
+                                    name: account.name,
+                                    error: error.message
+                                }
+                            };
+                        }
+                    }
+                }));
                 const successes = [];
                 const failures = [];
-                for (const account of targets)try {
-                    const refreshed = await this.refreshQuotaForAccount(account.name);
-                    successes.push(await this.quotaSummaryForAccount(refreshed.account));
-                } catch (error) {
-                    failures.push({
-                        name: account.name,
-                        error: error.message
-                    });
-                }
+                for (const result of results)if (result) if ("success" in result) successes.push(result.success);
+                else failures.push(result.failure);
                 return {
                     successes,
                     failures
@@ -885,12 +905,12 @@ var __webpack_modules__ = {
 
 Usage:
   codexm current [--json]
-  codexm list [--json]
+  codexm list [name] [--json]
   codexm save <name> [--force] [--json]
   codexm update [--json]
   codexm quota refresh [name] [--json]
-  codexm quota list [--json]
   codexm switch <name> [--json]
+  codexm switch --auto [--dry-run] [--json]
   codexm remove <name> [--yes] [--json]
   codexm rename <old> <new> [--json]
   codexm doctor [--json]
@@ -911,47 +931,6 @@ Account names must match /^[A-Za-z0-9][A-Za-z0-9._-]{0,63}$/.
             for (const warning of status.warnings)lines.push(`Warning: ${warning}`);
             return lines.join("\n");
         }
-        function describeAccounts(accounts, warnings) {
-            if (0 === accounts.length) return 0 === warnings.length ? "No saved accounts." : warnings.map((warning)=>`Warning: ${warning}`).join("\n");
-            const table = formatTable(accounts.map((account)=>({
-                    name: account.name,
-                    account_id: maskAccountId(account.account_id),
-                    auth_mode: account.auth_mode,
-                    saved: account.created_at,
-                    switched: account.last_switched_at ?? "-",
-                    flags: account.duplicateAccountId ? "duplicate-account-id" : "-"
-                })), [
-                {
-                    key: "name",
-                    label: "NAME"
-                },
-                {
-                    key: "account_id",
-                    label: "ACCOUNT ID"
-                },
-                {
-                    key: "auth_mode",
-                    label: "AUTH MODE"
-                },
-                {
-                    key: "saved",
-                    label: "SAVED AT"
-                },
-                {
-                    key: "switched",
-                    label: "LAST SWITCHED"
-                },
-                {
-                    key: "flags",
-                    label: "FLAGS"
-                }
-            ]);
-            const lines = [
-                table
-            ];
-            for (const warning of warnings)lines.push(`Warning: ${warning}`);
-            return lines.join("\n");
-        }
         function describeDoctor(report) {
             const lines = [
                 report.healthy ? "Doctor checks passed." : "Doctor checks found issues.",
@@ -970,17 +949,106 @@ Account names must match /^[A-Za-z0-9][A-Za-z0-9._-]{0,63}$/.
             if (!window?.reset_at) return "-";
             return external_dayjs_default().utc(window.reset_at).tz(external_dayjs_default().tz.guess()).format("MM-DD HH:mm");
         }
+        function computeAvailability(account) {
+            if ("ok" !== account.status) return null;
+            const usedPercents = [
+                account.five_hour?.used_percent,
+                account.one_week?.used_percent
+            ].filter((value)=>"number" == typeof value);
+            if (0 === usedPercents.length) return null;
+            if (usedPercents.some((value)=>value >= 100)) return "unavailable";
+            if (usedPercents.some((value)=>100 - value < 10)) return "almost unavailable";
+            return "available";
+        }
+        function toCliQuotaSummary(account) {
+            const { status, ...rest } = account;
+            return {
+                ...rest,
+                available: computeAvailability(account),
+                refresh_status: status
+            };
+        }
+        function toCliQuotaRefreshResult(result) {
+            return {
+                successes: result.successes.map(toCliQuotaSummary),
+                failures: result.failures
+            };
+        }
+        function computeRemainingPercent(usedPercent) {
+            if ("number" != typeof usedPercent) return null;
+            return Math.max(0, 100 - usedPercent);
+        }
+        function toAutoSwitchCandidate(account) {
+            if ("ok" !== account.status) return null;
+            const remain5h = computeRemainingPercent(account.five_hour?.used_percent);
+            const remain1w = computeRemainingPercent(account.one_week?.used_percent);
+            if (null === remain5h || null === remain1w) return null;
+            return {
+                name: account.name,
+                account_id: account.account_id,
+                plan_type: account.plan_type,
+                available: computeAvailability(account),
+                refresh_status: "ok",
+                effective_score: Math.min(remain5h, 3 * remain1w),
+                remain_5h: remain5h,
+                remain_1w_eq_5h: 3 * remain1w,
+                five_hour_used: account.five_hour?.used_percent ?? 0,
+                one_week_used: account.one_week?.used_percent ?? 0,
+                five_hour_reset_at: account.five_hour?.reset_at ?? null,
+                one_week_reset_at: account.one_week?.reset_at ?? null
+            };
+        }
+        function compareNullableDateAscending(left, right) {
+            if (left === right) return 0;
+            if (null === left) return 1;
+            if (null === right) return -1;
+            return left.localeCompare(right);
+        }
+        function rankAutoSwitchCandidates(accounts) {
+            return accounts.map(toAutoSwitchCandidate).filter((candidate)=>null !== candidate).sort((left, right)=>{
+                if (right.effective_score !== left.effective_score) return right.effective_score - left.effective_score;
+                if (right.remain_5h !== left.remain_5h) return right.remain_5h - left.remain_5h;
+                if (right.remain_1w_eq_5h !== left.remain_1w_eq_5h) return right.remain_1w_eq_5h - left.remain_1w_eq_5h;
+                const fiveHourResetOrder = compareNullableDateAscending(left.five_hour_reset_at, right.five_hour_reset_at);
+                if (0 !== fiveHourResetOrder) return fiveHourResetOrder;
+                const oneWeekResetOrder = compareNullableDateAscending(left.one_week_reset_at, right.one_week_reset_at);
+                if (0 !== oneWeekResetOrder) return oneWeekResetOrder;
+                return left.name.localeCompare(right.name);
+            });
+        }
+        function describeAutoSwitchSelection(candidate, dryRun, backupPath, warnings) {
+            const lines = [
+                dryRun ? `Best account: "${candidate.name}" (${maskAccountId(candidate.account_id)}).` : `Auto-switched to "${candidate.name}" (${maskAccountId(candidate.account_id)}).`,
+                `Score: ${candidate.effective_score}`,
+                `5H remaining: ${candidate.remain_5h}%`,
+                `1W remaining (5H-equivalent): ${candidate.remain_1w_eq_5h}%`
+            ];
+            if (backupPath) lines.push(`Backup: ${backupPath}`);
+            for (const warning of warnings)lines.push(`Warning: ${warning}`);
+            return lines.join("\n");
+        }
+        function describeAutoSwitchNoop(candidate, warnings) {
+            const lines = [
+                `Current account "${candidate.name}" (${maskAccountId(candidate.account_id)}) is already the best available account.`,
+                `Score: ${candidate.effective_score}`,
+                `5H remaining: ${candidate.remain_5h}%`,
+                `1W remaining (5H-equivalent): ${candidate.remain_1w_eq_5h}%`
+            ];
+            for (const warning of warnings)lines.push(`Warning: ${warning}`);
+            return lines.join("\n");
+        }
         function describeQuotaAccounts(accounts, warnings) {
             if (0 === accounts.length) return 0 === warnings.length ? "No saved accounts." : warnings.map((warning)=>`Warning: ${warning}`).join("\n");
             const table = formatTable(accounts.map((account)=>({
                     name: account.name,
                     account_id: maskAccountId(account.account_id),
                     plan_type: account.plan_type ?? "-",
+                    available: computeAvailability(account) ?? "-",
                     five_hour: formatUsagePercent(account.five_hour),
                     five_hour_reset: formatResetAt(account.five_hour),
                     one_week: formatUsagePercent(account.one_week),
                     one_week_reset: formatResetAt(account.one_week),
-                    status: account.status
+                    refresh_status: account.status
                 })), [
                 {
                     key: "name",
@@ -994,6 +1062,10 @@ Account names must match /^[A-Za-z0-9][A-Za-z0-9._-]{0,63}$/.
                     key: "plan_type",
                     label: "PLAN TYPE"
                 },
+                {
+                    key: "available",
+                    label: "AVAILABLE"
+                },
                 {
                     key: "five_hour",
                     label: "5H USED"
@@ -1011,8 +1083,8 @@ Account names must match /^[A-Za-z0-9][A-Za-z0-9._-]{0,63}$/.
                     label: "1W RESET AT"
                 },
                 {
-                    key: "status",
-                    label: "STATUS"
+                    key: "refresh_status",
+                    label: "REFRESH STATUS"
                 }
             ]);
             const lines = [
@@ -1068,10 +1140,11 @@ Account names must match /^[A-Za-z0-9][A-Za-z0-9._-]{0,63}$/.
                         }
                     case "list":
                         {
-                            const result = await store.listAccounts();
-                            if (json) writeJson(streams.stdout, result);
-                            else streams.stdout.write(`${describeAccounts(result.accounts, result.warnings)}\n`);
-                            return 0;
+                            const targetName = parsed.positionals[0];
+                            const result = await store.refreshAllQuotas(targetName);
+                            if (json) writeJson(streams.stdout, toCliQuotaRefreshResult(result));
+                            else streams.stdout.write(`${describeQuotaRefresh(result)}\n`);
+                            return 0 === result.failures.length ? 0 : 1;
                         }
                     case "save":
                         {
@@ -1099,7 +1172,8 @@ Account names must match /^[A-Za-z0-9][A-Za-z0-9._-]{0,63}$/.
                             try {
                                 const quotaResult = await store.refreshQuotaForAccount(result.account.name);
                                 const quotaList = await store.listQuotaSummaries();
-                                quota = quotaList.accounts.find((account)=>account.name === quotaResult.account.name) ?? null;
+                                const matched = quotaList.accounts.find((account)=>account.name === quotaResult.account.name) ?? null;
+                                quota = matched ? toCliQuotaSummary(matched) : null;
                             } catch (error) {
                                 warnings.push(error.message);
                             }
@@ -1124,31 +1198,93 @@ Account names must match /^[A-Za-z0-9][A-Za-z0-9._-]{0,63}$/.
                     case "quota":
                         {
                             const quotaCommand = parsed.positionals[0];
-                            if ("list" === quotaCommand) {
-                                const result = await store.listQuotaSummaries();
-                                if (json) writeJson(streams.stdout, result);
-                                else streams.stdout.write(`${describeQuotaAccounts(result.accounts, result.warnings)}\n`);
-                                return 0;
-                            }
                             if ("refresh" === quotaCommand) {
                                 const targetName = parsed.positionals[1];
                                 const result = await store.refreshAllQuotas(targetName);
-                                if (json) writeJson(streams.stdout, result);
+                                if (json) writeJson(streams.stdout, toCliQuotaRefreshResult(result));
                                 else streams.stdout.write(`${describeQuotaRefresh(result)}\n`);
                                 return 0 === result.failures.length ? 0 : 1;
                             }
-                            throw new Error("Usage: codexm quota <refresh [name] | list> [--json]");
+                            throw new Error("Usage: codexm quota refresh [name] [--json]");
                         }
                     case "switch":
                         {
+                            const auto = parsed.flags.has("--auto");
+                            const dryRun = parsed.flags.has("--dry-run");
                             const name = parsed.positionals[0];
+                            if (dryRun && !auto) throw new Error("Usage: codexm switch --auto [--dry-run] [--json]");
+                            if (auto) {
+                                if (name) throw new Error("Usage: codexm switch --auto [--dry-run] [--json]");
+                                const refreshResult = await store.refreshAllQuotas();
+                                const candidates = rankAutoSwitchCandidates(refreshResult.successes);
+                                if (0 === candidates.length) throw new Error("No auto-switch candidate has both 5H and 1W quota data available.");
+                                const selected = candidates[0];
+                                const selectedQuota = refreshResult.successes.find((account)=>account.name === selected.name) ?? null;
+                                const warnings = refreshResult.failures.map((failure)=>`${failure.name}: ${failure.error}`);
+                                if (dryRun) {
+                                    const payload = {
+                                        ok: true,
+                                        action: "switch",
+                                        mode: "auto",
+                                        dry_run: true,
+                                        selected,
+                                        candidates,
+                                        warnings
+                                    };
+                                    if (json) writeJson(streams.stdout, payload);
+                                    else streams.stdout.write(`${describeAutoSwitchSelection(selected, true, null, warnings)}\n`);
+                                    return 0 === refreshResult.failures.length ? 0 : 1;
+                                }
+                                const currentStatus = await store.getCurrentStatus();
+                                if ("available" === selected.available && currentStatus.matched_accounts.includes(selected.name)) {
+                                    const payload = {
+                                        ok: true,
+                                        action: "switch",
+                                        mode: "auto",
+                                        skipped: true,
+                                        reason: "already_current_best",
+                                        account: {
+                                            name: selected.name,
+                                            account_id: selected.account_id
+                                        },
+                                        selected,
+                                        candidates,
+                                        quota: selectedQuota ? toCliQuotaSummary(selectedQuota) : null,
+                                        warnings
+                                    };
+                                    if (json) writeJson(streams.stdout, payload);
+                                    else streams.stdout.write(`${describeAutoSwitchNoop(selected, warnings)}\n`);
+                                    return 0 === refreshResult.failures.length ? 0 : 1;
+                                }
+                                const result = await store.switchAccount(selected.name);
+                                for (const warning of warnings)result.warnings.push(warning);
+                                const payload = {
+                                    ok: true,
+                                    action: "switch",
+                                    mode: "auto",
+                                    account: {
+                                        name: result.account.name,
+                                        account_id: result.account.account_id,
+                                        auth_mode: result.account.auth_mode
+                                    },
+                                    selected,
+                                    candidates,
+                                    quota: selectedQuota ? toCliQuotaSummary(selectedQuota) : null,
+                                    backup_path: result.backup_path,
+                                    warnings: result.warnings
+                                };
+                                if (json) writeJson(streams.stdout, payload);
+                                else streams.stdout.write(`${describeAutoSwitchSelection(selected, false, result.backup_path, result.warnings)}\n`);
+                                return 0 === refreshResult.failures.length ? 0 : 1;
+                            }
                             if (!name) throw new Error("Usage: codexm switch <name>");
                             const result = await store.switchAccount(name);
                             let quota = null;
                             try {
                                 await store.refreshQuotaForAccount(result.account.name);
                                 const quotaList = await store.listQuotaSummaries();
-                                quota = quotaList.accounts.find((account)=>account.name === result.account.name) ?? null;
+                                const matched = quotaList.accounts.find((account)=>account.name === result.account.name) ?? null;
+                                quota = matched ? toCliQuotaSummary(matched) : null;
                             } catch (error) {
                                 result.warnings.push(error.message);
                             }

package/dist/main.cjs

@@ -439,6 +439,7 @@ const DIRECTORY_MODE = 448;
 const FILE_MODE = 384;
 const SCHEMA_VERSION = 1;
 const ACCOUNT_NAME_PATTERN = /^[A-Za-z0-9][A-Za-z0-9._-]{0,63}$/;
+const QUOTA_REFRESH_CONCURRENCY = 3;
 function defaultPaths(homeDir = (0, external_node_os_namespaceObject.homedir)()) {
     const codexDir = (0, external_node_path_namespaceObject.join)(homeDir, ".codex");
     const codexTeamDir = (0, external_node_path_namespaceObject.join)(homeDir, ".codex-team");
@@ -789,17 +790,36 @@ class AccountStore {
         const { accounts } = await this.listAccounts();
         const targets = targetName ? accounts.filter((account)=>account.name === targetName) : accounts;
         if (targetName && 0 === targets.length) throw new Error(`Account "${targetName}" does not exist.`);
+        const results = new Array(targets.length);
+        let nextIndex = 0;
+        const workerCount = Math.min(QUOTA_REFRESH_CONCURRENCY, targets.length);
+        await Promise.all(Array.from({
+            length: workerCount
+        }, async ()=>{
+            while(true){
+                const index = nextIndex;
+                nextIndex += 1;
+                if (index >= targets.length) return;
+                const account = targets[index];
+                try {
+                    const refreshed = await this.refreshQuotaForAccount(account.name);
+                    results[index] = {
+                        success: await this.quotaSummaryForAccount(refreshed.account)
+                    };
+                } catch (error) {
+                    results[index] = {
+                        failure: {
+                            name: account.name,
+                            error: error.message
+                        }
+                    };
+                }
+            }
+        }));
         const successes = [];
         const failures = [];
-        for (const account of targets)try {
-            const refreshed = await this.refreshQuotaForAccount(account.name);
-            successes.push(await this.quotaSummaryForAccount(refreshed.account));
-        } catch (error) {
-            failures.push({
-                name: account.name,
-                error: error.message
-            });
-        }
+        for (const result of results)if (result) if ("success" in result) successes.push(result.success);
+        else failures.push(result.failure);
         return {
             successes,
             failures
@@ -915,12 +935,12 @@ function printHelp(stream) {
 
 Usage:
   codexm current [--json]
-  codexm list [--json]
+  codexm list [name] [--json]
   codexm save <name> [--force] [--json]
   codexm update [--json]
   codexm quota refresh [name] [--json]
-  codexm quota list [--json]
   codexm switch <name> [--json]
+  codexm switch --auto [--dry-run] [--json]
   codexm remove <name> [--yes] [--json]
   codexm rename <old> <new> [--json]
   codexm doctor [--json]
@@ -941,47 +961,6 @@ function describeCurrentStatus(status) {
     for (const warning of status.warnings)lines.push(`Warning: ${warning}`);
     return lines.join("\n");
 }
-function describeAccounts(accounts, warnings) {
-    if (0 === accounts.length) return 0 === warnings.length ? "No saved accounts." : warnings.map((warning)=>`Warning: ${warning}`).join("\n");
-    const table = formatTable(accounts.map((account)=>({
-            name: account.name,
-            account_id: maskAccountId(account.account_id),
-            auth_mode: account.auth_mode,
-            saved: account.created_at,
-            switched: account.last_switched_at ?? "-",
-            flags: account.duplicateAccountId ? "duplicate-account-id" : "-"
-        })), [
-        {
-            key: "name",
-            label: "NAME"
-        },
-        {
-            key: "account_id",
-            label: "ACCOUNT ID"
-        },
-        {
-            key: "auth_mode",
-            label: "AUTH MODE"
-        },
-        {
-            key: "saved",
-            label: "SAVED AT"
-        },
-        {
-            key: "switched",
-            label: "LAST SWITCHED"
-        },
-        {
-            key: "flags",
-            label: "FLAGS"
-        }
-    ]);
-    const lines = [
-        table
-    ];
-    for (const warning of warnings)lines.push(`Warning: ${warning}`);
-    return lines.join("\n");
-}
 function describeDoctor(report) {
     const lines = [
         report.healthy ? "Doctor checks passed." : "Doctor checks found issues.",
@@ -1000,17 +979,106 @@ function formatResetAt(window) {
     if (!window?.reset_at) return "-";
     return external_dayjs_default().utc(window.reset_at).tz(external_dayjs_default().tz.guess()).format("MM-DD HH:mm");
 }
+function computeAvailability(account) {
+    if ("ok" !== account.status) return null;
+    const usedPercents = [
+        account.five_hour?.used_percent,
+        account.one_week?.used_percent
+    ].filter((value)=>"number" == typeof value);
+    if (0 === usedPercents.length) return null;
+    if (usedPercents.some((value)=>value >= 100)) return "unavailable";
+    if (usedPercents.some((value)=>100 - value < 10)) return "almost unavailable";
+    return "available";
+}
+function toCliQuotaSummary(account) {
+    const { status, ...rest } = account;
+    return {
+        ...rest,
+        available: computeAvailability(account),
+        refresh_status: status
+    };
+}
+function toCliQuotaRefreshResult(result) {
+    return {
+        successes: result.successes.map(toCliQuotaSummary),
+        failures: result.failures
+    };
+}
+function computeRemainingPercent(usedPercent) {
+    if ("number" != typeof usedPercent) return null;
+    return Math.max(0, 100 - usedPercent);
+}
+function toAutoSwitchCandidate(account) {
+    if ("ok" !== account.status) return null;
+    const remain5h = computeRemainingPercent(account.five_hour?.used_percent);
+    const remain1w = computeRemainingPercent(account.one_week?.used_percent);
+    if (null === remain5h || null === remain1w) return null;
+    return {
+        name: account.name,
+        account_id: account.account_id,
+        plan_type: account.plan_type,
+        available: computeAvailability(account),
+        refresh_status: "ok",
+        effective_score: Math.min(remain5h, 3 * remain1w),
+        remain_5h: remain5h,
+        remain_1w_eq_5h: 3 * remain1w,
+        five_hour_used: account.five_hour?.used_percent ?? 0,
+        one_week_used: account.one_week?.used_percent ?? 0,
+        five_hour_reset_at: account.five_hour?.reset_at ?? null,
+        one_week_reset_at: account.one_week?.reset_at ?? null
+    };
+}
+function compareNullableDateAscending(left, right) {
+    if (left === right) return 0;
+    if (null === left) return 1;
+    if (null === right) return -1;
+    return left.localeCompare(right);
+}
+function rankAutoSwitchCandidates(accounts) {
+    return accounts.map(toAutoSwitchCandidate).filter((candidate)=>null !== candidate).sort((left, right)=>{
+        if (right.effective_score !== left.effective_score) return right.effective_score - left.effective_score;
+        if (right.remain_5h !== left.remain_5h) return right.remain_5h - left.remain_5h;
+        if (right.remain_1w_eq_5h !== left.remain_1w_eq_5h) return right.remain_1w_eq_5h - left.remain_1w_eq_5h;
+        const fiveHourResetOrder = compareNullableDateAscending(left.five_hour_reset_at, right.five_hour_reset_at);
+        if (0 !== fiveHourResetOrder) return fiveHourResetOrder;
+        const oneWeekResetOrder = compareNullableDateAscending(left.one_week_reset_at, right.one_week_reset_at);
+        if (0 !== oneWeekResetOrder) return oneWeekResetOrder;
+        return left.name.localeCompare(right.name);
+    });
+}
+function describeAutoSwitchSelection(candidate, dryRun, backupPath, warnings) {
+    const lines = [
+        dryRun ? `Best account: "${candidate.name}" (${maskAccountId(candidate.account_id)}).` : `Auto-switched to "${candidate.name}" (${maskAccountId(candidate.account_id)}).`,
+        `Score: ${candidate.effective_score}`,
+        `5H remaining: ${candidate.remain_5h}%`,
+        `1W remaining (5H-equivalent): ${candidate.remain_1w_eq_5h}%`
+    ];
+    if (backupPath) lines.push(`Backup: ${backupPath}`);
+    for (const warning of warnings)lines.push(`Warning: ${warning}`);
+    return lines.join("\n");
+}
+function describeAutoSwitchNoop(candidate, warnings) {
+    const lines = [
+        `Current account "${candidate.name}" (${maskAccountId(candidate.account_id)}) is already the best available account.`,
+        `Score: ${candidate.effective_score}`,
+        `5H remaining: ${candidate.remain_5h}%`,
+        `1W remaining (5H-equivalent): ${candidate.remain_1w_eq_5h}%`
+    ];
+    for (const warning of warnings)lines.push(`Warning: ${warning}`);
+    return lines.join("\n");
+}
 function describeQuotaAccounts(accounts, warnings) {
     if (0 === accounts.length) return 0 === warnings.length ? "No saved accounts." : warnings.map((warning)=>`Warning: ${warning}`).join("\n");
     const table = formatTable(accounts.map((account)=>({
             name: account.name,
             account_id: maskAccountId(account.account_id),
             plan_type: account.plan_type ?? "-",
+            available: computeAvailability(account) ?? "-",
             five_hour: formatUsagePercent(account.five_hour),
             five_hour_reset: formatResetAt(account.five_hour),
             one_week: formatUsagePercent(account.one_week),
             one_week_reset: formatResetAt(account.one_week),
-            status: account.status
+            refresh_status: account.status
         })), [
         {
             key: "name",
@@ -1024,6 +1092,10 @@ function describeQuotaAccounts(accounts, warnings) {
             key: "plan_type",
             label: "PLAN TYPE"
         },
+        {
+            key: "available",
+            label: "AVAILABLE"
+        },
         {
             key: "five_hour",
             label: "5H USED"
@@ -1041,8 +1113,8 @@ function describeQuotaAccounts(accounts, warnings) {
             label: "1W RESET AT"
         },
         {
-            key: "status",
-            label: "STATUS"
+            key: "refresh_status",
+            label: "REFRESH STATUS"
         }
     ]);
     const lines = [
@@ -1098,10 +1170,11 @@ async function runCli(argv, options = {}) {
                 }
             case "list":
                 {
-                    const result = await store.listAccounts();
-                    if (json) writeJson(streams.stdout, result);
-                    else streams.stdout.write(`${describeAccounts(result.accounts, result.warnings)}\n`);
-                    return 0;
+                    const targetName = parsed.positionals[0];
+                    const result = await store.refreshAllQuotas(targetName);
+                    if (json) writeJson(streams.stdout, toCliQuotaRefreshResult(result));
+                    else streams.stdout.write(`${describeQuotaRefresh(result)}\n`);
+                    return 0 === result.failures.length ? 0 : 1;
                 }
             case "save":
                 {
@@ -1129,7 +1202,8 @@ async function runCli(argv, options = {}) {
                     try {
                         const quotaResult = await store.refreshQuotaForAccount(result.account.name);
                         const quotaList = await store.listQuotaSummaries();
-                        quota = quotaList.accounts.find((account)=>account.name === quotaResult.account.name) ?? null;
+                        const matched = quotaList.accounts.find((account)=>account.name === quotaResult.account.name) ?? null;
+                        quota = matched ? toCliQuotaSummary(matched) : null;
                     } catch (error) {
                         warnings.push(error.message);
                     }
@@ -1154,31 +1228,93 @@ async function runCli(argv, options = {}) {
             case "quota":
                 {
                     const quotaCommand = parsed.positionals[0];
-                    if ("list" === quotaCommand) {
-                        const result = await store.listQuotaSummaries();
-                        if (json) writeJson(streams.stdout, result);
-                        else streams.stdout.write(`${describeQuotaAccounts(result.accounts, result.warnings)}\n`);
-                        return 0;
-                    }
                     if ("refresh" === quotaCommand) {
                         const targetName = parsed.positionals[1];
                         const result = await store.refreshAllQuotas(targetName);
-                        if (json) writeJson(streams.stdout, result);
+                        if (json) writeJson(streams.stdout, toCliQuotaRefreshResult(result));
                         else streams.stdout.write(`${describeQuotaRefresh(result)}\n`);
                         return 0 === result.failures.length ? 0 : 1;
                     }
-                    throw new Error("Usage: codexm quota <refresh [name] | list> [--json]");
+                    throw new Error("Usage: codexm quota refresh [name] [--json]");
                 }
             case "switch":
                 {
+                    const auto = parsed.flags.has("--auto");
+                    const dryRun = parsed.flags.has("--dry-run");
                     const name = parsed.positionals[0];
+                    if (dryRun && !auto) throw new Error("Usage: codexm switch --auto [--dry-run] [--json]");
+                    if (auto) {
+                        if (name) throw new Error("Usage: codexm switch --auto [--dry-run] [--json]");
+                        const refreshResult = await store.refreshAllQuotas();
+                        const candidates = rankAutoSwitchCandidates(refreshResult.successes);
+                        if (0 === candidates.length) throw new Error("No auto-switch candidate has both 5H and 1W quota data available.");
+                        const selected = candidates[0];
+                        const selectedQuota = refreshResult.successes.find((account)=>account.name === selected.name) ?? null;
+                        const warnings = refreshResult.failures.map((failure)=>`${failure.name}: ${failure.error}`);
+                        if (dryRun) {
+                            const payload = {
+                                ok: true,
+                                action: "switch",
+                                mode: "auto",
+                                dry_run: true,
+                                selected,
+                                candidates,
+                                warnings
+                            };
+                            if (json) writeJson(streams.stdout, payload);
+                            else streams.stdout.write(`${describeAutoSwitchSelection(selected, true, null, warnings)}\n`);
+                            return 0 === refreshResult.failures.length ? 0 : 1;
+                        }
+                        const currentStatus = await store.getCurrentStatus();
+                        if ("available" === selected.available && currentStatus.matched_accounts.includes(selected.name)) {
+                            const payload = {
+                                ok: true,
+                                action: "switch",
+                                mode: "auto",
+                                skipped: true,
+                                reason: "already_current_best",
+                                account: {
+                                    name: selected.name,
+                                    account_id: selected.account_id
+                                },
+                                selected,
+                                candidates,
+                                quota: selectedQuota ? toCliQuotaSummary(selectedQuota) : null,
+                                warnings
+                            };
+                            if (json) writeJson(streams.stdout, payload);
+                            else streams.stdout.write(`${describeAutoSwitchNoop(selected, warnings)}\n`);
+                            return 0 === refreshResult.failures.length ? 0 : 1;
+                        }
+                        const result = await store.switchAccount(selected.name);
+                        for (const warning of warnings)result.warnings.push(warning);
+                        const payload = {
+                            ok: true,
+                            action: "switch",
+                            mode: "auto",
+                            account: {
+                                name: result.account.name,
+                                account_id: result.account.account_id,
+                                auth_mode: result.account.auth_mode
+                            },
+                            selected,
+                            candidates,
+                            quota: selectedQuota ? toCliQuotaSummary(selectedQuota) : null,
+                            backup_path: result.backup_path,
+                            warnings: result.warnings
+                        };
+                        if (json) writeJson(streams.stdout, payload);
+                        else streams.stdout.write(`${describeAutoSwitchSelection(selected, false, result.backup_path, result.warnings)}\n`);
+                        return 0 === refreshResult.failures.length ? 0 : 1;
+                    }
                     if (!name) throw new Error("Usage: codexm switch <name>");
                     const result = await store.switchAccount(name);
                     let quota = null;
                     try {
                         await store.refreshQuotaForAccount(result.account.name);
                         const quotaList = await store.listQuotaSummaries();
-                        quota = quotaList.accounts.find((account)=>account.name === result.account.name) ?? null;
+                        const matched = quotaList.accounts.find((account)=>account.name === result.account.name) ?? null;
+                        quota = matched ? toCliQuotaSummary(matched) : null;
                     } catch (error) {
                         result.warnings.push(error.message);
                     }

package/dist/main.js

@@ -399,6 +399,7 @@ const DIRECTORY_MODE = 448;
 const FILE_MODE = 384;
 const SCHEMA_VERSION = 1;
 const ACCOUNT_NAME_PATTERN = /^[A-Za-z0-9][A-Za-z0-9._-]{0,63}$/;
+const QUOTA_REFRESH_CONCURRENCY = 3;
 function defaultPaths(homeDir = homedir()) {
     const codexDir = join(homeDir, ".codex");
     const codexTeamDir = join(homeDir, ".codex-team");
@@ -749,17 +750,36 @@ class AccountStore {
         const { accounts } = await this.listAccounts();
         const targets = targetName ? accounts.filter((account)=>account.name === targetName) : accounts;
         if (targetName && 0 === targets.length) throw new Error(`Account "${targetName}" does not exist.`);
+        const results = new Array(targets.length);
+        let nextIndex = 0;
+        const workerCount = Math.min(QUOTA_REFRESH_CONCURRENCY, targets.length);
+        await Promise.all(Array.from({
+            length: workerCount
+        }, async ()=>{
+            while(true){
+                const index = nextIndex;
+                nextIndex += 1;
+                if (index >= targets.length) return;
+                const account = targets[index];
+                try {
+                    const refreshed = await this.refreshQuotaForAccount(account.name);
+                    results[index] = {
+                        success: await this.quotaSummaryForAccount(refreshed.account)
+                    };
+                } catch (error) {
+                    results[index] = {
+                        failure: {
+                            name: account.name,
+                            error: error.message
+                        }
+                    };
+                }
+            }
+        }));
         const successes = [];
         const failures = [];
-        for (const account of targets)try {
-            const refreshed = await this.refreshQuotaForAccount(account.name);
-            successes.push(await this.quotaSummaryForAccount(refreshed.account));
-        } catch (error) {
-            failures.push({
-                name: account.name,
-                error: error.message
-            });
-        }
+        for (const result of results)if (result) if ("success" in result) successes.push(result.success);
+        else failures.push(result.failure);
         return {
             successes,
             failures
@@ -875,12 +895,12 @@ function printHelp(stream) {
 
 Usage:
   codexm current [--json]
-  codexm list [--json]
+  codexm list [name] [--json]
   codexm save <name> [--force] [--json]
   codexm update [--json]
   codexm quota refresh [name] [--json]
-  codexm quota list [--json]
   codexm switch <name> [--json]
+  codexm switch --auto [--dry-run] [--json]
   codexm remove <name> [--yes] [--json]
   codexm rename <old> <new> [--json]
   codexm doctor [--json]
@@ -901,47 +921,6 @@ function describeCurrentStatus(status) {
     for (const warning of status.warnings)lines.push(`Warning: ${warning}`);
     return lines.join("\n");
 }
-function describeAccounts(accounts, warnings) {
-    if (0 === accounts.length) return 0 === warnings.length ? "No saved accounts." : warnings.map((warning)=>`Warning: ${warning}`).join("\n");
-    const table = formatTable(accounts.map((account)=>({
-            name: account.name,
-            account_id: maskAccountId(account.account_id),
-            auth_mode: account.auth_mode,
-            saved: account.created_at,
-            switched: account.last_switched_at ?? "-",
-            flags: account.duplicateAccountId ? "duplicate-account-id" : "-"
-        })), [
-        {
-            key: "name",
-            label: "NAME"
-        },
-        {
-            key: "account_id",
-            label: "ACCOUNT ID"
-        },
-        {
-            key: "auth_mode",
-            label: "AUTH MODE"
-        },
-        {
-            key: "saved",
-            label: "SAVED AT"
-        },
-        {
-            key: "switched",
-            label: "LAST SWITCHED"
-        },
-        {
-            key: "flags",
-            label: "FLAGS"
-        }
-    ]);
-    const lines = [
-        table
-    ];
-    for (const warning of warnings)lines.push(`Warning: ${warning}`);
-    return lines.join("\n");
-}
 function describeDoctor(report) {
     const lines = [
         report.healthy ? "Doctor checks passed." : "Doctor checks found issues.",
@@ -960,17 +939,106 @@ function formatResetAt(window) {
     if (!window?.reset_at) return "-";
     return dayjs.utc(window.reset_at).tz(dayjs.tz.guess()).format("MM-DD HH:mm");
 }
+function computeAvailability(account) {
+    if ("ok" !== account.status) return null;
+    const usedPercents = [
+        account.five_hour?.used_percent,
+        account.one_week?.used_percent
+    ].filter((value)=>"number" == typeof value);
+    if (0 === usedPercents.length) return null;
+    if (usedPercents.some((value)=>value >= 100)) return "unavailable";
+    if (usedPercents.some((value)=>100 - value < 10)) return "almost unavailable";
+    return "available";
+}
+function toCliQuotaSummary(account) {
+    const { status, ...rest } = account;
+    return {
+        ...rest,
+        available: computeAvailability(account),
+        refresh_status: status
+    };
+}
+function toCliQuotaRefreshResult(result) {
+    return {
+        successes: result.successes.map(toCliQuotaSummary),
+        failures: result.failures
+    };
+}
+function computeRemainingPercent(usedPercent) {
+    if ("number" != typeof usedPercent) return null;
+    return Math.max(0, 100 - usedPercent);
+}
+function toAutoSwitchCandidate(account) {
+    if ("ok" !== account.status) return null;
+    const remain5h = computeRemainingPercent(account.five_hour?.used_percent);
+    const remain1w = computeRemainingPercent(account.one_week?.used_percent);
+    if (null === remain5h || null === remain1w) return null;
+    return {
+        name: account.name,
+        account_id: account.account_id,
+        plan_type: account.plan_type,
+        available: computeAvailability(account),
+        refresh_status: "ok",
+        effective_score: Math.min(remain5h, 3 * remain1w),
+        remain_5h: remain5h,
+        remain_1w_eq_5h: 3 * remain1w,
+        five_hour_used: account.five_hour?.used_percent ?? 0,
+        one_week_used: account.one_week?.used_percent ?? 0,
+        five_hour_reset_at: account.five_hour?.reset_at ?? null,
+        one_week_reset_at: account.one_week?.reset_at ?? null
+    };
+}
+function compareNullableDateAscending(left, right) {
+    if (left === right) return 0;
+    if (null === left) return 1;
+    if (null === right) return -1;
+    return left.localeCompare(right);
+}
+function rankAutoSwitchCandidates(accounts) {
+    return accounts.map(toAutoSwitchCandidate).filter((candidate)=>null !== candidate).sort((left, right)=>{
+        if (right.effective_score !== left.effective_score) return right.effective_score - left.effective_score;
+        if (right.remain_5h !== left.remain_5h) return right.remain_5h - left.remain_5h;
+        if (right.remain_1w_eq_5h !== left.remain_1w_eq_5h) return right.remain_1w_eq_5h - left.remain_1w_eq_5h;
+        const fiveHourResetOrder = compareNullableDateAscending(left.five_hour_reset_at, right.five_hour_reset_at);
+        if (0 !== fiveHourResetOrder) return fiveHourResetOrder;
+        const oneWeekResetOrder = compareNullableDateAscending(left.one_week_reset_at, right.one_week_reset_at);
+        if (0 !== oneWeekResetOrder) return oneWeekResetOrder;
+        return left.name.localeCompare(right.name);
+    });
+}
+function describeAutoSwitchSelection(candidate, dryRun, backupPath, warnings) {
+    const lines = [
+        dryRun ? `Best account: "${candidate.name}" (${maskAccountId(candidate.account_id)}).` : `Auto-switched to "${candidate.name}" (${maskAccountId(candidate.account_id)}).`,
+        `Score: ${candidate.effective_score}`,
+        `5H remaining: ${candidate.remain_5h}%`,
+        `1W remaining (5H-equivalent): ${candidate.remain_1w_eq_5h}%`
+    ];
+    if (backupPath) lines.push(`Backup: ${backupPath}`);
+    for (const warning of warnings)lines.push(`Warning: ${warning}`);
+    return lines.join("\n");
+}
+function describeAutoSwitchNoop(candidate, warnings) {
+    const lines = [
+        `Current account "${candidate.name}" (${maskAccountId(candidate.account_id)}) is already the best available account.`,
+        `Score: ${candidate.effective_score}`,
+        `5H remaining: ${candidate.remain_5h}%`,
+        `1W remaining (5H-equivalent): ${candidate.remain_1w_eq_5h}%`
+    ];
+    for (const warning of warnings)lines.push(`Warning: ${warning}`);
+    return lines.join("\n");
+}
 function describeQuotaAccounts(accounts, warnings) {
     if (0 === accounts.length) return 0 === warnings.length ? "No saved accounts." : warnings.map((warning)=>`Warning: ${warning}`).join("\n");
     const table = formatTable(accounts.map((account)=>({
             name: account.name,
             account_id: maskAccountId(account.account_id),
             plan_type: account.plan_type ?? "-",
+            available: computeAvailability(account) ?? "-",
             five_hour: formatUsagePercent(account.five_hour),
             five_hour_reset: formatResetAt(account.five_hour),
             one_week: formatUsagePercent(account.one_week),
             one_week_reset: formatResetAt(account.one_week),
-            status: account.status
+            refresh_status: account.status
         })), [
         {
             key: "name",
@@ -984,6 +1052,10 @@ function describeQuotaAccounts(accounts, warnings) {
             key: "plan_type",
             label: "PLAN TYPE"
         },
+        {
+            key: "available",
+            label: "AVAILABLE"
+        },
         {
             key: "five_hour",
             label: "5H USED"
@@ -1001,8 +1073,8 @@ function describeQuotaAccounts(accounts, warnings) {
             label: "1W RESET AT"
         },
         {
-            key: "status",
-            label: "STATUS"
+            key: "refresh_status",
+            label: "REFRESH STATUS"
         }
     ]);
     const lines = [
@@ -1058,10 +1130,11 @@ async function runCli(argv, options = {}) {
                 }
             case "list":
                 {
-                    const result = await store.listAccounts();
-                    if (json) writeJson(streams.stdout, result);
-                    else streams.stdout.write(`${describeAccounts(result.accounts, result.warnings)}\n`);
-                    return 0;
+                    const targetName = parsed.positionals[0];
+                    const result = await store.refreshAllQuotas(targetName);
+                    if (json) writeJson(streams.stdout, toCliQuotaRefreshResult(result));
+                    else streams.stdout.write(`${describeQuotaRefresh(result)}\n`);
+                    return 0 === result.failures.length ? 0 : 1;
                 }
             case "save":
                 {
@@ -1089,7 +1162,8 @@ async function runCli(argv, options = {}) {
                     try {
                         const quotaResult = await store.refreshQuotaForAccount(result.account.name);
                         const quotaList = await store.listQuotaSummaries();
-                        quota = quotaList.accounts.find((account)=>account.name === quotaResult.account.name) ?? null;
+                        const matched = quotaList.accounts.find((account)=>account.name === quotaResult.account.name) ?? null;
+                        quota = matched ? toCliQuotaSummary(matched) : null;
                     } catch (error) {
                         warnings.push(error.message);
                     }
@@ -1114,31 +1188,93 @@ async function runCli(argv, options = {}) {
             case "quota":
                 {
                     const quotaCommand = parsed.positionals[0];
-                    if ("list" === quotaCommand) {
-                        const result = await store.listQuotaSummaries();
-                        if (json) writeJson(streams.stdout, result);
-                        else streams.stdout.write(`${describeQuotaAccounts(result.accounts, result.warnings)}\n`);
-                        return 0;
-                    }
                     if ("refresh" === quotaCommand) {
                         const targetName = parsed.positionals[1];
                         const result = await store.refreshAllQuotas(targetName);
-                        if (json) writeJson(streams.stdout, result);
+                        if (json) writeJson(streams.stdout, toCliQuotaRefreshResult(result));
                         else streams.stdout.write(`${describeQuotaRefresh(result)}\n`);
                         return 0 === result.failures.length ? 0 : 1;
                     }
-                    throw new Error("Usage: codexm quota <refresh [name] | list> [--json]");
+                    throw new Error("Usage: codexm quota refresh [name] [--json]");
                 }
             case "switch":
                 {
+                    const auto = parsed.flags.has("--auto");
+                    const dryRun = parsed.flags.has("--dry-run");
                     const name = parsed.positionals[0];
+                    if (dryRun && !auto) throw new Error("Usage: codexm switch --auto [--dry-run] [--json]");
+                    if (auto) {
+                        if (name) throw new Error("Usage: codexm switch --auto [--dry-run] [--json]");
+                        const refreshResult = await store.refreshAllQuotas();
+                        const candidates = rankAutoSwitchCandidates(refreshResult.successes);
+                        if (0 === candidates.length) throw new Error("No auto-switch candidate has both 5H and 1W quota data available.");
+                        const selected = candidates[0];
+                        const selectedQuota = refreshResult.successes.find((account)=>account.name === selected.name) ?? null;
+                        const warnings = refreshResult.failures.map((failure)=>`${failure.name}: ${failure.error}`);
+                        if (dryRun) {
+                            const payload = {
+                                ok: true,
+                                action: "switch",
+                                mode: "auto",
+                                dry_run: true,
+                                selected,
+                                candidates,
+                                warnings
+                            };
+                            if (json) writeJson(streams.stdout, payload);
+                            else streams.stdout.write(`${describeAutoSwitchSelection(selected, true, null, warnings)}\n`);
+                            return 0 === refreshResult.failures.length ? 0 : 1;
+                        }
+                        const currentStatus = await store.getCurrentStatus();
+                        if ("available" === selected.available && currentStatus.matched_accounts.includes(selected.name)) {
+                            const payload = {
+                                ok: true,
+                                action: "switch",
+                                mode: "auto",
+                                skipped: true,
+                                reason: "already_current_best",
+                                account: {
+                                    name: selected.name,
+                                    account_id: selected.account_id
+                                },
+                                selected,
+                                candidates,
+                                quota: selectedQuota ? toCliQuotaSummary(selectedQuota) : null,
+                                warnings
+                            };
+                            if (json) writeJson(streams.stdout, payload);
+                            else streams.stdout.write(`${describeAutoSwitchNoop(selected, warnings)}\n`);
+                            return 0 === refreshResult.failures.length ? 0 : 1;
+                        }
+                        const result = await store.switchAccount(selected.name);
+                        for (const warning of warnings)result.warnings.push(warning);
+                        const payload = {
+                            ok: true,
+                            action: "switch",
+                            mode: "auto",
+                            account: {
+                                name: result.account.name,
+                                account_id: result.account.account_id,
+                                auth_mode: result.account.auth_mode
+                            },
+                            selected,
+                            candidates,
+                            quota: selectedQuota ? toCliQuotaSummary(selectedQuota) : null,
+                            backup_path: result.backup_path,
+                            warnings: result.warnings
+                        };
+                        if (json) writeJson(streams.stdout, payload);
+                        else streams.stdout.write(`${describeAutoSwitchSelection(selected, false, result.backup_path, result.warnings)}\n`);
+                        return 0 === refreshResult.failures.length ? 0 : 1;
+                    }
                     if (!name) throw new Error("Usage: codexm switch <name>");
                     const result = await store.switchAccount(name);
                     let quota = null;
                     try {
                         await store.refreshQuotaForAccount(result.account.name);
                         const quotaList = await store.listQuotaSummaries();
-                        quota = quotaList.accounts.find((account)=>account.name === result.account.name) ?? null;
+                        const matched = quotaList.accounts.find((account)=>account.name === result.account.name) ?? null;
+                        quota = matched ? toCliQuotaSummary(matched) : null;
                     } catch (error) {
                         result.warnings.push(error.message);
                     }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "codex-team",
-  "version": "0.0.1",
+  "version": "0.0.3",
   "description": "Manage multiple Codex ChatGPT auth snapshots and quota usage from the command line.",
   "license": "MIT",
   "type": "module",