# Gemini on Windows

Gemini support is preview support. The Windows public preview requires Gemini CLI OAuth credentials.

## Credential Source

CodexBar checks `%USERPROFILE%\.gemini\oauth_creds.json`. Sign in with the Gemini CLI using OAuth before enabling Gemini in CodexBar.

API key and Vertex AI Gemini CLI modes are not supported for preview usage display.

## What CodexBar Reads

The app reads the Gemini CLI OAuth access token, refresh token, ID token, and expiry timestamp from `oauth_creds.json`. The ID token is used to display the account email when the claim is available.

## Endpoint Family

CodexBar calls Google Gemini Code Assist quota endpoint families with the local OAuth access token. If the token is expired and a refresh token is available, it uses Google's OAuth token endpoint to refresh credentials.

## What Is Displayed

The tray popover can show:

- Gemini account email when available
- Plan family such as Free, Paid, Workspace, or Legacy when returned by the quota response
- Pro model usage
- Flash model usage
- Reset times for quota buckets when returned by Gemini

## Common Setup Errors

- `oauth_creds.json` is missing: run Gemini CLI OAuth sign-in.
- API key or Vertex AI mode is selected: switch Gemini CLI to OAuth for preview support.
- Token refresh fails: update or reinstall the Gemini CLI, then sign in again.
- No quota buckets appear: Gemini may have changed the preview quota API response shape.