feat(cli): add per-account quota to ocx account list by lidge-jun · Pull Request #2587 · lidge-jun/opencodex

lidge-jun · 2026-08-25T16:45:59Z

Summary

Closes #2566.

The proxy already probes per-credential usage (fetchProviderAccountQuotas) and exposes it
at /api/oauth/accounts?provider=…&quota=1, and the dashboard already renders it. The CLI
just never passed quota=1, so a headless or SSH session had to hand-roll an authenticated
curl against the management API — with the admin token read off disk — to answer "which
account has quota left before I start a long session".

--quota opts into the probe and adds a QUOTA column. It stays opt-in because the server
probes the upstream once per stored credential; the default listing remains a local read.
--refresh bypasses the cached result.

Two details worth naming:

An unprobed provider shows - and a failed probe shows unavailable. Blank would read as
"no usage" rather than "not measured", which is the wrong thing to tell someone choosing an
account.
Two DTO spellings reach the same field: the per-account probe reports fiveHourPercent
while the Codex pool reports the same idea as shortPercent. Both render as 5h.

Verification

Against a live proxy with three Anthropic logins:

$ ocx account list anthropic --quota
PROVIDER   TYPE   ID                                PLAN/LABEL         PRIORITY  STATUS  QUOTA
anthropic  oauth  1278f8da                          a***r@big5lms.com  -                 5h 7% wk 62%
anthropic  oauth  e112f28b                          k***1@gmail.com    -         active  5h 9% wk 45%
anthropic  oauth  b245be9769d72f90b5f1d1c6c1ab4baf  l***n@gmail.com    -                 5h 0% wk 98%

Exactly the decision the issue describes: the active account is at 45% weekly while a sibling
sits at 98%.

The default listing is unchanged (no QUOTA column), and a full --quota run shows - for
providers without a per-account probe. --json carries the complete breakdown.

$ bun test tests/cli-headless-parity.test.ts
 36 pass, 0 fail

$ bun x tsc --noEmit
(clean)

Docs updated in docs-site/src/content/docs/reference/cli/providers-accounts.md.

Checklist

Targets dev
Based on the current dev head
Verified against a live proxy, not only in tests
Docs updated for the user-facing flag
Typecheck clean
Account identifiers in the output above are the CLI's own masked form

The proxy already probes per-credential usage and the dashboard already renders it, but no CLI command exposed it: fetchOAuthRows never passed quota=1, so a headless or SSH session had to hand-roll an authenticated curl against the management API to answer 'which account has quota left'. --quota opts into the probe and adds a QUOTA column; the default listing stays a cheap local read. --refresh bypasses the server TTL. An unprobed provider shows '-' and a failed probe shows 'unavailable', because blank would read as no usage rather than not measured. Two DTO spellings reach the same field - the per-account probe reports fiveHourPercent, the Codex pool reports shortPercent - and both render as 5h.

coderabbitai · 2026-08-25T16:46:08Z

Warning

Review limit reached

Next included review available in 20 seconds.

View limit details

Limit details: You’ve used all 10 included reviews currently available.

You've used all free OSS reviews for now. Wait for the free limit to reset to keep reviewing this public repository.

Learn how review limits work.

Review configuration:

⚙️ Run configuration

Configuration used: Path: .coderabbit.yaml

Review profile: ASSERTIVE

Plan: Pro Plus

Run ID: 17ecf620-3349-412c-93c9-f01c02493a3e

📥 Commits

Reviewing files that changed from the base of the PR and between 073ae69 and ddefc73.

📒 Files selected for processing (4)

docs-site/src/content/docs/reference/cli/providers-accounts.md
src/cli/account-api.ts
src/cli/account.ts
tests/cli-headless-parity.test.ts

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

_{Comment @coderabbitai help to get the list of available commands.}

github-actions · 2026-08-25T16:46:11Z

✅ Deterministic PR hygiene checks passed.

chatgpt-codex-connector

💡 Codex Review

Here are some automated review suggestions for this pull request.

Reviewed commit: ddefc7358d

ℹ️ About Codex in GitHub

Your team has set up Codex to review pull requests in this repo. Reviews are triggered when you

Open a pull request for review
Mark a draft as ready
Comment "@codex review".

If Codex has suggestions, it will comment; otherwise it will react with 👍.

Codex can also answer questions or update the PR. Try commenting "@codex address that feedback".

chatgpt-codex-connector · 2026-08-25T16:50:41Z

+  quota?: { refresh?: boolean },
+): Promise<FamilyRows> {
  if (type === "codex") return fetchCodexRows(deps, baseUrl);


Forward quota requests to Codex account reads

When the target is openai, including the Codex rows in an unqualified list, the new quota option reaches fetchRows but this branch drops it and calls fetchCodexRows with its default false. Consequently, ocx account list openai --quota [--refresh] neither adds ?refresh=1 nor projects the returned quota, so every Codex row displays - and the newly supported shortPercent rendering is unreachable. Pass separate include-quota and refresh state into the Codex reader, and cover the command-level request/output path rather than only the formatter.

AGENTS.md reference: src/AGENTS.md:L24-L25

Useful? React with 👍 / 👎.

chatgpt-codex-connector · 2026-08-25T16:50:41Z

+  const wantsQuota = consumeFlag(rest, "--quota");
+  const refreshQuota = consumeFlag(rest, "--refresh");


Reject or honor refresh when quota is omitted

If an operator runs ocx account list anthropic --refresh without --quota, both flags are accepted and removed, but the request options are discarded because wantsQuota is false; the command exits successfully with an ordinary cached/non-quota listing. Since the usage nests --refresh under --quota, this unsupported combination should return a usage error, or --refresh should imply quota, with focused argument-path coverage.

AGENTS.md reference: src/AGENTS.md:L24-L25

Useful? React with 👍 / 👎.

chatgpt-codex-connector · 2026-08-25T16:50:41Z

 ```

-### `ocx account list [provider] [--json] [--all]`
+### `ocx account list [provider] [--json] [--all] [--quota [--refresh]]`


Synchronize quota documentation across translated pages

The English page now documents the new flags and conditional QUOTA column, but all seven translated copies found under docs-site/src/content/docs/{fr,ja,ko,ru,tr,zh-cn,zh-tw}/reference/cli/providers-accounts.md still publish the old list [provider] [--json] [--all] signature and six-column output. Users viewing those locales therefore cannot discover this workflow and receive a stale command contract; update each directly affected page alongside the canonical source.

AGENTS.md reference: docs-site/AGENTS.md:L15-L16

Useful? React with 👍 / 👎.

The proxy already probes per-credential usage and the dashboard already renders it, but no CLI command exposed it: fetchOAuthRows never passed quota=1, so a headless or SSH session had to hand-roll an authenticated curl against the management API to answer 'which account has quota left'. --quota opts into the probe and adds a QUOTA column; the default listing stays a cheap local read. --refresh bypasses the server TTL. An unprobed provider shows '-' and a failed probe shows 'unavailable', because blank would read as no usage rather than not measured. Two DTO spellings reach the same field - the per-account probe reports fiveHourPercent, the Codex pool reports shortPercent - and both render as 5h.

lidge-jun requested a review from Ingwannu as a code owner August 25, 2026 16:46

lidge-jun merged commit 11c3f7e into dev Aug 25, 2026
8 checks passed

lidge-jun deleted the codex/account-quota-2566 branch August 25, 2026 16:46

lidge-jun mentioned this pull request Aug 25, 2026

[Feature]: expose per-account Anthropic quota in ocx account list #2566

Closed

3 tasks done

github-actions Bot added the enhancement New feature or request label Aug 25, 2026

chatgpt-codex-connector Bot reviewed Aug 25, 2026

View reviewed changes

x3M3x mentioned this pull request Aug 25, 2026

feat(combos): add random, least-used, and reset-window routing strategies #2050

Merged

3 of 7 tasks

lidge-jun mentioned this pull request Aug 25, 2026

docs: document promptCacheKey for custom openai-chat providers (#2541) #2625

Merged

4 tasks done

Navigation Menu

Repository navigation

feat(cli): add per-account quota to ocx account list - #2587

feat(cli): add per-account quota to ocx account list#2587
lidge-jun merged 1 commit into
devfrom
codex/account-quota-2566

lidge-jun commented Aug 25, 2026

Uh oh!

coderabbitai Bot commented Aug 25, 2026

Review limit reached

Uh oh!

github-actions Bot commented Aug 25, 2026

Uh oh!

Uh oh!

chatgpt-codex-connector Bot left a comment

Uh oh!

chatgpt-codex-connector Bot Aug 25, 2026

Uh oh!

chatgpt-codex-connector Bot Aug 25, 2026

Uh oh!

chatgpt-codex-connector Bot Aug 25, 2026

Uh oh!

Reviewers

Uh oh!

Assignees

Labels

Projects

Milestone

Development

Uh oh!

1 participant

		const wantsQuota = consumeFlag(rest, "--quota");
		const refreshQuota = consumeFlag(rest, "--refresh");

Conversation

lidge-jun commented Aug 25, 2026

Summary

Verification

Checklist

Uh oh!

coderabbitai Bot commented Aug 25, 2026

Review limit reached

Uh oh!

github-actions Bot commented Aug 25, 2026

Uh oh!

Uh oh!

chatgpt-codex-connector Bot left a comment

Choose a reason for hiding this comment

💡 Codex Review

Uh oh!

chatgpt-codex-connector Bot Aug 25, 2026

Choose a reason for hiding this comment

Uh oh!

chatgpt-codex-connector Bot Aug 25, 2026

Choose a reason for hiding this comment

Uh oh!

chatgpt-codex-connector Bot Aug 25, 2026

Choose a reason for hiding this comment

Uh oh!

Reviewers

Uh oh!

Assignees

Labels

Projects

Milestone

Development

Uh oh!

1 participant