Lidget is a Windows 11 taskbar widget that shows the usage limits of AI subscription plans. It tracks Claude (Pro and Max plans, through Claude Code) and Codex (ChatGPT plans, through the Codex CLI). The name joins "limits" and "widget".
| Your task | Read |
|---|---|
| Install and use Lidget | User guide |
| See what Lidget reads and writes | Data sources and files |
| Build Lidget or propose a change | CONTRIBUTING.md and Development |
| Find another document | Documentation index |
- The widget shows the tightest limit of each provider as a bar and a percentage. By default, the percentage is the share of the limit that is left. A setting changes it to the used share. A tick on each bar marks the even-pace level. A setting removes the tick. The Rings style shows each provider as two rings instead: the weekly limit outside, and the session limit inside.
- A dot on a provider logo shows that the provider has a banked reset.
- A click on the widget opens a flyout. For each provider, the flyout shows:
- The session limit (5 hours) and the weekly limit, with reset countdowns.
- The pace of each limit: on pace, in reserve, or in deficit. If a limit runs out before its reset at the current rate, an amber text shows the time until it runs out.
- The API-equivalent cost for today, the last 7 days, and the last 30 days, from local session logs.
- A history chart of the last 24 hours or 7 days.
- The banked resets, with their expiry times and history. You can use a reset from the flyout, after a confirmation.
- A notification shows when the used share of a limit passes 80% and 95%. Another notification shows 24 hours and 2 hours before a banked reset expires.
- Claude values update while you work, from the T3 Code logs or from the Claude Code statusline. Lidget also reads the usage response that Claude Code saves. Lidget then sends fewer requests to the Claude usage endpoint, which Anthropic rate-limits.
- If Lidget cannot join the taskbar, or the widget would cover taskbar buttons, the widget moves to a small window in the screen corner.
- Lidget checks GitHub Releases for updates every 24 hours, and installs a downloaded update at the next start.
- Download
Lidget-win-Setup.exefrom the latest release. - Run the installer. It is not signed, so SmartScreen can show a warning. Select More info, and then Run anyway.
Lidget needs Windows 11 with the taskbar at the bottom of the screen.
For Claude values, sign in to Claude Code with a Pro or Max plan.
For Codex values, install the Codex CLI and run codex login.
The user guide has the full steps.
Prerequisites: Windows 11 and the .NET 10 SDK.
dotnet build Lidget.sln
dotnet test Lidget.slnDevelopment describes the Debug build, the environment variables, and packaging.
Lidget uses the MIT license. THIRD-PARTY-NOTICES.md lists the code, data, and packages from other projects.