AI Tools
Gemini CLI usage: start with the two environment variables
A key in the environment turns a free tier into per-token billing without telling you.
Gemini CLI usage comes down to a question most guides skip: which account did the command use? The same binary can draw on a free tier, a billed API key, a Vertex project or a workspace policy, and each has its own ceiling and reset. The UsageAtlas guide sorts the four.
Start with the login
| Sign-in | Ceiling | Reset |
|---|---|---|
| Personal Google account | Free-tier requests and tokens | Rolling |
| API key | Spend, per token | Per minute and per day |
| Vertex AI | Project quota | Per project |
| Workspace | Admin policy | Per settings |
If you do not know which applies, the CLI's help output and two environment variables will tell you.
The two variables that matter
GEMINI_API_KEY and GOOGLE_API_KEY can override an account login. When one is set, the free-tier rules stop applying and the console becomes the place to look.
That is the most common cause of a confusing quota message: the user believes they are on a free tier while a key quietly bills a project.
What consumes the ceiling fastest
- Pointing at a whole repository instead of two files.
- Keeping one session open all day.
- A long instruction file that is resent every turn.
- Exploration on the largest model available.
None of those requires a plan change to fix, and the second is usually the largest.
Where to read the number
The CLI's own quota output and the Google console. Both are authoritative; neither is a guess.
A local tracker can tell you what a task cost after the fact. It cannot see a free-tier allowance, and any tool that claims to is inferring rather than reading.
The June 2026 change
Free and Google One users moved from Gemini CLI to Antigravity CLI. If the reset rules or the panel's location surprise you, that is the likely reason, and the current tool's panel is the one to trust.
Building a baseline anyway
Even with the rules moving, a baseline is durable. Track a normal week, note the median and the heaviest day, and use that as the reference for the next tool.
The number describes your work, not the vendor's meter, so it survives a rename.
FAQ
Does the free tier still exist?
There is an account path with request and token limits. Read the current CLI for the terms that apply to you.
Why did my quota rules change?
Some account types moved to Antigravity CLI in June 2026, which changed the limits those users see.
Can I see remaining quota in a third-party app?
Not reliably for this tool. Use the CLI or console for the ceiling and a tracker for the detail.
The short version
Find the login, read the panel, and reduce context. The plan is the last lever, not the first.