Repository navigation
free-tier: Free usage limit reached after minimal normal use on 2.1.4 desktop #59252
Closed as not planned
Description
Summary
On OpenCode Desktop 2.1.4 (Windows, no providers connected), the built-in free models return Free usage limit reached after minimal, normal use. The cap is shared across free models, so switching models does not recover the session, and the limit value and reset window are not documented.
Environment
- opencode version: 2.1.4 (
opencode-cli --version→opencode v2.1.4) - OS: Microsoft Windows [Version 10.0.26200.9711], win32 x64
- Terminal: OpenCode Desktop app (Electron);
TERM=xterm-256color,TERM_PROGRAMunset - Shell:
C:\WINDOWS\system32\cmd.exe - Install/channel: desktop app under
%LOCALAPPDATA%\Programs\@opencodedesktop, channellatest, updater reports 2.1.4 is current - Active plugins: none found (no
opencode.json/opencode.jsoncin project or global config, no.opencode/pluginor.opencode/plugins)
Reproduction
- Launch OpenCode Desktop 2.1.4 with no providers connected (
opencode auth list→No authenticated integrations). - Select a free model, e.g.
opencode/deepseek-v4.1-flash-free. - Do a short session of normal coding work.
- Send the next prompt.
Expected Behavior
Free models stay usable for normal, non-abusive use. At minimum, the limit should be documented with its reset window, and the UI should show remaining quota before a request fails.
Actual Behavior
Every subsequent request fails with:
AI.Error: Free usage limit reached. Free models work in OpenCode (https://opencode.ai); subscribe to OpenCode Go to keep going: https://opencode.ai/go
The error is not retryable and there is no fallback to another free model, so the session is blocked until the window resets.
Additional Context
- First occurrence:
2026-10-25T10:50:33.902Z. Recurred ~15 times through2026-10-25T15:42:16.605Z, still reproducible on 2026-10-26. - Provider state (redacted):
provider: opencode
baseURL: https://opencode.ai/inference/openai/v1
apiKey: public
model: deepseek-v4.1-flash-free
- Log excerpt:
timestamp=2026-10-25T10:50:33.902Z level=ERROR run=<redacted> message="Failed to drain Session" cause="AI.Error: Free usage limit reached. Free models work in OpenCode (https://opencode.ai); subscribe to OpenCode Go to keep going: https://opencode.ai/go"
- Workarounds tried: none yet.
- Possibly related: [closed] #42019, Free Usage Exceeded on 1st use after signup #39310, Free Tier Limit Hit ? #32971, Free usage exceeded, subscribe to Go #40078.
- Note: if this is intended free-tier behavior, the request is for a documented limit, a visible reset time, and graceful handling instead of an unretryable session error.
Reacted by Konstantin, Shaun Clayton and Rukkhadevata
Activity
opencode-agent commentedon Oct 26, 2026
Thanks for the detailed report, @Jamester-Mulato, and sorry about the trouble. Being blocked by "Free usage limit reached" after only a short session is frustrating.
The free-model allowance, how it is counted and when it resets are decided by the OpenCode Zen service for your account, not by the desktop app. OpenCode only shows the error it gets back. Billing and account support is not handled in GitHub issues, so please email help@anoma.ly with the details (when it started, the model, and the timestamps from your logs). If you have already emailed, the team will get to it, especially now that we have seen it here. Please keep email addresses, payment details and account information out of this public issue and put them only in the email.
The other things you asked for are already tracked here:
Other recent reports of the same thing: #59026, #58963, #59054, #59185, #59200.
The bot will close this issue in 1 day.
Vidyut commentedon Oct 26, 2026
I'm facing the same issue on Ubuntu desktop app. I couldn't possibly have abused the limits because I haven't been able to connect at all for four days. Before this, I had only once faced a limit. I don't use it that much. I am confident I am not exceeding limits. It simply keeps extending the block.
konfou commentedon Oct 26, 2026
@Vidyut If on v1, try updating to v2. If using snap
sudo snap install opencode --channel=2/stable --classic. (Note that snap v2 lacks desktop component.) Though OP also on v2 and they get the same error, this solved it for me.Vidyut commentedon Oct 26, 2026
It worked. I updated to v2 and everything is fine, though I no longer have the desktop app - using it in browser for now.
opencode-agent commentedon Oct 27, 2026
Closing this now, since billing and account support happens by email rather than in GitHub issues. Thanks again for the detailed report, @Jamester-Mulato.
If you still have a question about your free-model allowance or its reset, please email help@anoma.ly. Please keep email addresses, payment details and account information in the email and out of this public issue.
Two feature requests here are still open and cover the other things you asked for: