# Usage Glance — community package

Usage Glance is a small, resizable Windows app that displays the exact usage allowances reported for your signed-in ChatGPT/Codex and Claude accounts. It runs as a normal GUI app, so it does not leave PowerShell or Command Prompt open.

This is a clean LEDD-AI/community template. It contains no account data, usernames, API keys, access tokens, saved readings, or personal file paths from its creator.

## Quick start

1. Extract the whole ZIP to a folder you control.
2. Complete the ChatGPT setup below. Complete the Claude setup only if you want Claude readings.
3. Double-click **Usage Glance.exe** and allow a few seconds for the first reading.

The executable is unsigned, so Windows may show a SmartScreen warning. Do not ignore a warning blindly: verify its checksum, inspect the included source, or rebuild it using `source\build.ps1`.

## ChatGPT/Codex setup

Usage Glance does not need an OpenAI API key. It uses the local Codex app service and your existing ChatGPT/Codex sign-in.

1. Install and sign in to the official Codex/ChatGPT tooling on this Windows account.
2. Confirm Codex works normally.
3. Open Usage Glance and wait for the ChatGPT badge to show **LIVE**.

The app starts `codex app-server --stdio` in the background and requests the signed-in account's rate limits. It does not copy or include your Codex authentication cache.

## Optional Claude setup

Usage Glance does not need a manually entered Anthropic API key. It uses the sign-in created by Claude Code.

1. Install Claude Code for Windows using Anthropic's official instructions.
2. Run `claude` once and complete the browser sign-in.
3. Confirm Claude Code works, then open Usage Glance.

At runtime, the app reads the OAuth sign-in in `%USERPROFILE%\.claude\.credentials.json`. If needed, it refreshes that token and writes the refreshed value back to the same Claude Code file. It never puts the token in the Usage Glance folder. This is an unofficial compatibility integration and may need updating if Anthropic changes Claude Code's format or usage endpoint.

## Using the app

- Drag the title bar to move it.
- Resize freely from any edge or corner. The interface scales to use the available space.
- The provider cards switch automatically between stacked and side-by-side layouts to suit the window shape.
- Use **S**, **M**, or **L** for quick sizes. The window stays anchored to the nearest side of the screen.
- Use the fill-screen button (or double-click the title bar) to fill the current monitor's work area; use it again to restore the previous size and position.
- Use the remaining title-bar controls to refresh, pin, minimise, or close.
- Use the arrow on a provider card to open that provider's usage page.
- Readings refresh every minute and are never estimated.

Window size, position, pin state, diagnostics, and the latest provider response are stored only for the current Windows user in `%LOCALAPPDATA%\UsageGlance`.

## What's new in 3.2

- Free resizing from every edge and corner, with smooth interface scaling.
- Automatic stacked or side-by-side layout selection based on the window shape.
- S/M/L quick-size buttons and a monitor-aware fill-screen/restore control.
- Remembered height as well as width and position.

## Troubleshooting

If a provider says **DISCONNECTED**, confirm its official app or command-line tool is installed and signed in for the same Windows user, then press refresh. ChatGPT requires the `codex` command; Claude requires the Claude Code credentials file described above.

To reset the app, close it and delete `%LOCALAPPDATA%\UsageGlance`. This does not sign you out of ChatGPT or Claude.

Never share `%USERPROFILE%\.codex\auth.json`, `%USERPROFILE%\.claude\.credentials.json`, copied tokens, API keys, or diagnostics containing account details.

## Verify or rebuild

The human-readable C# source and icon are included in `source`. On standard 64-bit Windows, inspect and run `source\build.ps1` with PowerShell. It uses the C# compiler included with Windows and downloads nothing.

Compare files with `SHA256SUMS.txt` before running them. The ZIP also has a separate `.sha256` file beside it.

## Sharing and distribution

You can put the ZIP on your LEDD-AI download page after testing it on a separate Windows account. Keep the README, privacy notice, MIT licence, source, and checksums with the executable.

This is a local desktop client, not a hosted usage service. Usage Glance is an independent community utility and is not affiliated with, endorsed by, or supported by OpenAI or Anthropic. ChatGPT, Codex, Claude, and Claude Code belong to their respective owners.

Usage Glance is released under the permissive MIT License. See `LICENSE.txt`.


