Accessibility improvements needed for rate limits display (/limits command) and rate limit warnings

Resolved 💬 2 comments Opened Sep 22, 2025 by ohqay Closed Sep 25, 2025

What version of Codex is running?

_No response_

Which model were you using?

_No response_

What platform is your computer?

_No response_

What steps can reproduce the bug?

Overview

The recently merged rate limits display (Tui: Rate limits #3977) has several UX and accessibility issues that make it difficult to read and understand.

<img width="884" height="574" alt="Image" src="https://github.com/user-attachments/assets/22a6abe3-a069-4ae4-b667-d0dc03f9aeb6" />

<img width="1014" height="192" alt="Image" src="https://github.com/user-attachments/assets/e073e299-5d0c-43e4-bdb6-dc61f49b221e" />

Issues Identified

1. Confusing tip text

Current: `Tip: run /limits right after Codex replies for freshest numbers
**Issue:** Awkward phrasing and unclear grammar make this hard to parse quickly
**Suggestion:**
Tip: Run /limits after Codex responses for the most current usage data.`

2. Poor visual chart design

Issue: The ASCII chart using repeated (>_) logos creates excessive visual noise that makes it difficult to quickly assess usage patterns
Suggestion: Consider simpler characters like or even just # . for better readability

3. Low contrast color scheme

Issue: Dark gray, green, and default colors are hard to distinguish, making users with visual impairments or different terminal themes struggle to read the chart
Suggestion: Use more distinct colors or add text indicators alongside colors (as mentioned in point 2 above)

4. Confusing legend descriptions

Issue: The legend mixes weekly and hourly concepts inconsistently, making "Default = weekly capacity beyond the hourly window" completely unclear. Additionally, using dark gray for used limits and default for remaining limits feels backward - muted colors should represent unused capacity, not what's already consumed.
Current legend:

  • Dark gray = weekly usage so far
  • Green = hourly capacity still available
  • Default = weekly capacity beyond the hourly window

Suggested legend:

  • Default = Used this week
  • Magenta = Remaining usage this hour
  • Dark gray = Weekly quota remaining

5. Unclear warning message

Current: `Hourly usage exceeded 50% of the limit. Run /limits for detailed usage.
**Issue:** Passive voice, repetition, and unclear call-to-action
**Suggestion:**
You've used 50% of your hourly limit. Run /limits for details.`

---

These changes would significantly improve usability for all users, especially those with visual impairments. Thanks for considering this feedback, and let me know if you need any more details!

What is the expected behavior?

_No response_

What do you see instead?

_No response_

Additional information

_No response_

View original on GitHub ↗

This issue has 2 comments on GitHub. Read the full discussion on GitHub ↗