Repository navigation
[FEATURE] Show when the free-tier usage window resets #60566
Description
Description
Summary
When the free-use allowance/rate limit is exhausted, OpenCode 2.x gives no
persistent indication of when the service will be usable again. An earlier
OpenCode version (reported by the user as 1.8) had a status line showing the
remaining wait. After upgrading to 2.2.1 this information is no longer visible.
Please provide an easy way to see when the free-use window opens again.
Motivation
I use the free tier for short interactive tasks. When I hit the limit, the only
way to know when I can continue is to retry periodically. That wastes time and
produces repeated failed requests. A visible countdown or reset timestamp would
let me plan when to come back.
Proposed behaviour
- In the TUI footer/status area, when free usage is unavailable, show:
Free usage available in 12m 34s, orFree usage window resets at 14:30
- Optionally show a warning as the limit approaches:
Free usage: 2 requests remaining - Add a
/usageor/statuscommand showing:- current plan/tier
- used and remaining free usage
- reset time / retry-after value
- When a request is rejected because the free window is closed, return
structured error data such asretry_after_secondsorreset_at, and display
it in the client. - Expose the same information through the HTTP API so terminal clients, the web
UI, and plugins can render it consistently. - If an exact countdown is unavailable, at least show the reset timestamp rather
than requiring trial and error.
Acceptance criteria
- A user who has exhausted free usage can see when it becomes available again
without repeatedly retrying. - The information is visible in the TUI and available through the API.
- The display remains accurate across restarts and does not expose account
secrets.
Environment
- OpenCode 2.2.1
- Linux
- TUI
- The user reports that a comparable status line existed in OpenCode 1.8.
Additional context
This is a usability/feature request, not a request to change the free-tier
limits themselves. Even a simple “available again at HH:MM” message would solve
most of the problem.
Plugins
No response
OpenCode version
No response
Steps to reproduce
No response
Screenshot
No response
Operating System
No response
Terminal
No response
Activity
opencodejr commentedon Oct 30, 2026
Thanks for the detailed write-up! I think this is a duplicate of #52894, which asks for the same thing: showing when free usage resets and how long is left, so you don't have to keep retrying. Comments there also ask for a
/usage-style command and for a warning before the limit is reached.In current v2 releases, the TUI's "Free limit reached" dialog and the notice in the session already show "Resets at …" when the server sends a reset time. There is no live countdown, persistent status line or
/usagecommand yet, and that's what #52894 is tracking.Possible duplicates and related issues, ordered by likelihood:
Please add your use case to #52894 (with a 👍) so it's all tracked in one place. The bot will close this issue as a duplicate in 1 day unless you reply explaining how your request is different.
tillea commentedon Oct 30, 2026
I added my use case to #52894 .
opencodejr commentedon Oct 31, 2026
We haven't heard back, so I'm closing this as a duplicate of #52894. That issue tracks the same request: showing when free usage resets and how long is left, plus a
/usage-style view. Please follow it and add your 👍 or use case there.Related issues: #40588 (remaining allowance and reset window), #42765 (warn before free usage runs out). If your request is actually different, reply here and we can reopen it. Thanks!