feat: show enterprise monthly credit limits in status by efrazer-oai · Pull Request #24812 · openai/codex

efrazer-oai · 2026-05-27T20:00:06Z

Summary

Enterprise users can have an effective monthly credit limit, but Codex /status currently drops that metadata from the account-usage response.

This change adds the optional spend_control.individual_limit projection to the existing rate-limit snapshot flow. The backend client reads the monthly limit, app-server exposes it as individualLimit, and the TUI renders a Monthly credit limit row through the existing progress-bar renderer.

When the backend does not return an effective monthly limit, existing rate-limit behavior is unchanged.

Existing backend state

The account-usage backend already returns the effective monthly limit and current usage together:

{
  "spend_control": {
    "reached": false,
    "individual_limit": {
      "limit": "25000",
      "used": "8000",
      "remaining": "17000",
      "used_percent": 32,
      "remaining_percent": 68,
      "reset_after_seconds": 86400,
      "reset_at": 1778137680
    }
  }
}

Before this change, Codex projected rolling primary and secondary windows plus credits. It ignored spend_control.individual_limit, so app-server clients and /status could not render the monthly cap.

The updated flow is:

account usage backend
  -> backend-client reads spend_control.individual_limit
  -> existing rate-limit snapshot carries optional individual_limit
  -> app-server exposes optional individualLimit
  -> TUI renders Monthly credit limit

App-server contract

account/rateLimits/read and sparse account/rateLimits/updated notifications now include an additive nullable rateLimits.individualLimit field:

{
  "individualLimit": {
    "limit": "25000",
    "used": "8000",
    "remainingPercent": 68,
    "resetsAt": 1778137680
  }
}

In an account/rateLimits/read response, null means no monthly limit is available. account/rateLimits/updated remains a sparse rolling notification: clients merge available values into their most recent account/rateLimits/read snapshot or refetch. Nullable account metadata in a rolling notification does not clear a previously observed value.

Design decisions

Extend the existing rate-limit snapshot instead of introducing a separate request or wire-level update protocol.
Keep the Codex projection narrow: /status needs the effective limit, current usage, remaining percentage, and reset timestamp.
Render the monthly row through the existing progress-bar renderer, with one optional detail line for 8,000 of 25,000 credits used.
Keep the backend response optional so existing accounts and older usage states preserve their current behavior.
Preserve cached monthly metadata when sparse rolling notifications omit it. Live account-usage reads remain authoritative and can clear a removed limit.

Visual evidence

 Monthly credit limit:   [██████████████░░░░░░] 68% left (resets 07:08 on 7 May)
                         8,000 of 25,000 credits used

Snapshot: codex-rs/tui/src/status/snapshots/codex_tui__status__tests__status_snapshot_includes_enterprise_monthly_credit_limit.snap

Testing

Tests: generated app-server schema verification, protocol tests, backend-client tests, app-server integration coverage, TUI snapshot coverage, formatting, and workspace lint cleanup.

efrazer-oai · 2026-05-27T20:00:50Z

@codex review

efrazer-oai · 2026-05-30T23:34:50Z

@codex review

chatgpt-codex-connector

💡 Codex Review

Here are some automated review suggestions for this pull request.

Reviewed commit: f17398727f

ℹ️ 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".

efrazer-oai · 2026-05-31T02:32:28Z

@codex review

chatgpt-codex-connector

💡 Codex Review

Here are some automated review suggestions for this pull request.

Reviewed commit: 60188c929e

ℹ️ 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".

efrazer-oai · 2026-05-31T03:19:10Z

@codex review

chatgpt-codex-connector

💡 Codex Review

Here are some automated review suggestions for this pull request.

Reviewed commit: 74f05dbace

ℹ️ 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".

efrazer-oai · 2026-05-31T04:01:05Z

@codex review

chatgpt-codex-connector

💡 Codex Review

Here are some automated review suggestions for this pull request.

Reviewed commit: 004371f16c

ℹ️ 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".

efrazer-oai · 2026-05-31T04:07:09Z

@codex review

chatgpt-codex-connector

💡 Codex Review

Here are some automated review suggestions for this pull request.

Reviewed commit: 22abe67fad

ℹ️ 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".

efrazer-oai · 2026-05-31T04:28:02Z

@codex review

chatgpt-codex-connector

💡 Codex Review

Here are some automated review suggestions for this pull request.

Reviewed commit: 67a1b69326

ℹ️ 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".

efrazer-oai · 2026-05-31T08:32:20Z

@codex review

chatgpt-codex-connector

💡 Codex Review

Here are some automated review suggestions for this pull request.

Reviewed commit: 8183ccb841

ℹ️ 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".

efrazer-oai · 2026-05-31T09:09:58Z

@codex review

efrazer-oai · 2026-05-31T09:45:35Z

@codex review

chatgpt-codex-connector

💡 Codex Review

Here are some automated review suggestions for this pull request.

Reviewed commit: d9c0ca8dd6

ℹ️ 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".

efrazer-oai · 2026-05-31T10:00:17Z

@codex review

chatgpt-codex-connector

💡 Codex Review

Here are some automated review suggestions for this pull request.

Reviewed commit: 0ffae9231b

ℹ️ 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".

efrazer-oai · 2026-05-31T10:26:09Z

@codex review

chatgpt-codex-connector

💡 Codex Review

Here are some automated review suggestions for this pull request.

Reviewed commit: 0ac6348b92

ℹ️ 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".

efrazer-oai · 2026-05-31T10:43:59Z

@codex review

chatgpt-codex-connector

💡 Codex Review

Here are some automated review suggestions for this pull request.

Reviewed commit: 9709e1c583

ℹ️ 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".

efrazer-oai · 2026-05-31T11:01:41Z

@codex review

chatgpt-codex-connector

💡 Codex Review

Here are some automated review suggestions for this pull request.

Reviewed commit: e5a1e19531

ℹ️ 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".

efrazer-oai · 2026-05-31T11:15:45Z

@codex review

chatgpt-codex-connector · 2026-05-31T11:19:01Z

Codex Review: Didn't find any major issues. Hooray!

ℹ️ 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

💡 Codex Review

Here are some automated review suggestions for this pull request.

Reviewed commit: f28d272942

ℹ️ 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".

efrazer-oai · 2026-06-02T03:19:07Z

@codex review

chatgpt-codex-connector · 2026-06-02T03:21:31Z

Security review completed. No security issues were found in this pull request.

View security finding report

ℹ️ About Codex security reviews in GitHub

This is an experimental Codex feature. Security reviews are triggered when:

You comment "@codex security review"
A regular code review gets triggered (for example, "@codex review" or when a PR is opened), and you’re opted in so security review runs alongside code review

Once complete, Codex will leave suggestions, or a comment if no findings are found.

chatgpt-codex-connector

💡 Codex Review

Here are some automated review suggestions for this pull request.

Reviewed commit: 8addd8104e

ℹ️ 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".

efrazer-oai · 2026-06-02T03:50:44Z

@codex review

chatgpt-codex-connector · 2026-06-02T03:58:37Z

Codex Review: Didn't find any major issues. 🚀

ℹ️ 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".

efrazer-oai · 2026-06-02T04:15:31Z

@codex review

chatgpt-codex-connector · 2026-06-02T04:19:48Z

Codex Review: Didn't find any major issues. What shall we delve into next?

ℹ️ 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".

efrazer-oai · 2026-06-02T04:23:08Z

/merge

chatgpt-codex-connector Bot reviewed May 30, 2026

View reviewed changes

Comment thread codex-rs/app-server-protocol/src/protocol/v2/account.rs

Comment thread codex-rs/tui/src/status/rate_limits.rs Outdated

Comment thread codex-rs/core/src/state/session.rs

chatgpt-codex-connector Bot reviewed May 31, 2026

View reviewed changes

Comment thread codex-rs/app-server-protocol/src/protocol/v2/account.rs Outdated

Comment thread codex-rs/core/src/state/session.rs

Comment thread codex-rs/protocol/src/protocol.rs Outdated

chatgpt-codex-connector Bot reviewed May 31, 2026

View reviewed changes

Comment thread codex-rs/backend-client/src/client.rs Outdated

Comment thread codex-rs/app-server-protocol/src/protocol/v2/account.rs Outdated

chatgpt-codex-connector Bot reviewed May 31, 2026

View reviewed changes

Comment thread codex-rs/app-server-protocol/src/protocol/v2/account.rs Outdated

Comment thread codex-rs/tui/src/status/card.rs Outdated

Comment thread codex-rs/tui/src/status/rate_limits.rs Outdated

chatgpt-codex-connector Bot reviewed May 31, 2026

View reviewed changes

Comment thread codex-rs/tui/src/chatwidget/rate_limits.rs Outdated

chatgpt-codex-connector Bot reviewed May 31, 2026

View reviewed changes

Comment thread codex-rs/protocol/src/protocol.rs Outdated

chatgpt-codex-connector Bot reviewed May 31, 2026

View reviewed changes

Comment thread codex-rs/app-server-protocol/src/protocol/v2/account.rs Outdated

Comment thread codex-rs/tui/src/chatwidget/rate_limits.rs

Comment thread codex-rs/core/tests/suite/client.rs

chatgpt-codex-connector Bot reviewed May 31, 2026

View reviewed changes

Comment thread codex-rs/app-server-protocol/src/protocol/v2/account.rs Outdated

chatgpt-codex-connector Bot reviewed May 31, 2026

View reviewed changes

Comment thread codex-rs/app-server-protocol/src/protocol/v2/account.rs Outdated

Comment thread codex-rs/app-server-protocol/src/protocol/v2/account.rs Outdated

Comment thread codex-rs/app-server-protocol/src/protocol/v2/account.rs

chatgpt-codex-connector Bot reviewed May 31, 2026

View reviewed changes

Comment thread codex-rs/app-server-protocol/src/protocol/v2/account.rs Outdated

chatgpt-codex-connector Bot reviewed May 31, 2026

View reviewed changes

Comment thread codex-rs/app-server-protocol/src/protocol/v2/account.rs Outdated

Comment thread codex-rs/app-server-protocol/src/protocol/v2/account.rs Outdated

chatgpt-codex-connector Bot reviewed May 31, 2026

View reviewed changes

Comment thread codex-rs/app-server-protocol/src/protocol/v2/account.rs

Comment thread codex-rs/app-server-protocol/src/protocol/v2/account.rs Outdated

efrazer-oai marked this pull request as ready for review June 1, 2026 19:42

efrazer-oai requested a review from a team as a code owner June 1, 2026 19:42

efrazer-oai added 15 commits June 1, 2026 20:12

fix: preserve explicit monthly limit clears

9a8770e

fix: preserve sparse monthly limit notifications

0c6a43a

fix: preserve explicit monthly limit clears in JSON

407eebd

fix: make monthly limit updates explicit

fed088a

fix: preserve older app-server rate limit notifications

5629e1a

fix: align app-server spend control schema

7e829be

fix: omit absent app-server monthly limits

39091ec

fix: stabilize app-server monthly limit fields

1f612ac

fix: default omitted monthly limit snapshots

144a7b4

refactor: simplify monthly credit limit status plumbing

d8446b6

fix: preserve monthly limits across rolling updates

8001158

fix: update rate-limit snapshot JSON expectations

fa8a899

fix: refresh enterprise monthly limit status snapshot

eaa479a

docs: clarify sparse app-server rate limit updates

157d1be

fix: preserve monthly limit freshness in status

8addd81

chatgpt-codex-connector Bot reviewed Jun 2, 2026

View reviewed changes

Comment thread codex-rs/tui/src/status/rate_limits.rs Outdated

efrazer-oai force-pushed the dev/efrazer/codex-ent-monthly-limit-status branch from f28d272 to 8addd81 Compare June 2, 2026 03:19

chatgpt-codex-connector Bot reviewed Jun 2, 2026

View reviewed changes

Comment thread codex-rs/protocol/src/protocol.rs

fix: preserve sparse monthly limit updates

e790a20

test: normalize status directory snapshots

9c2d1ae

efrazer-oai merged commit c8e5db1 into main Jun 2, 2026
31 checks passed

efrazer-oai deleted the dev/efrazer/codex-ent-monthly-limit-status branch June 2, 2026 04:25

github-actions Bot locked and limited conversation to collaborators Jun 2, 2026

Conversation

efrazer-oai commented May 27, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Summary

Existing backend state

App-server contract

Design decisions

Visual evidence

Testing

Uh oh!

efrazer-oai commented May 27, 2026

Uh oh!

efrazer-oai commented May 30, 2026

Uh oh!

chatgpt-codex-connector Bot left a comment

Choose a reason for hiding this comment

💡 Codex Review

Uh oh!

Uh oh!

Uh oh!

Uh oh!

efrazer-oai commented May 31, 2026

Uh oh!

chatgpt-codex-connector Bot left a comment

Choose a reason for hiding this comment

💡 Codex Review

Uh oh!

Uh oh!

Uh oh!

Uh oh!

efrazer-oai commented May 31, 2026

Uh oh!

chatgpt-codex-connector Bot left a comment

Choose a reason for hiding this comment

💡 Codex Review

Uh oh!

Uh oh!

Uh oh!

efrazer-oai commented May 31, 2026

Uh oh!

chatgpt-codex-connector Bot left a comment

Choose a reason for hiding this comment

💡 Codex Review

Uh oh!

Uh oh!

Uh oh!

Uh oh!

efrazer-oai commented May 31, 2026

Uh oh!

chatgpt-codex-connector Bot left a comment

Choose a reason for hiding this comment

💡 Codex Review

Uh oh!

Uh oh!

efrazer-oai commented May 31, 2026

Uh oh!

chatgpt-codex-connector Bot left a comment

Choose a reason for hiding this comment

💡 Codex Review

Uh oh!

Uh oh!

efrazer-oai commented May 31, 2026

Uh oh!

chatgpt-codex-connector Bot left a comment

Choose a reason for hiding this comment

💡 Codex Review

Uh oh!

Uh oh!

Uh oh!

Uh oh!

efrazer-oai commented May 31, 2026

Uh oh!

efrazer-oai commented May 31, 2026

Uh oh!

chatgpt-codex-connector Bot left a comment

Choose a reason for hiding this comment

💡 Codex Review

Uh oh!

Uh oh!

efrazer-oai commented May 31, 2026

efrazer-oai commented May 27, 2026 •

edited

Loading