跳到正文
GitHub·· 9 天前AI 评分38

Kvotar：macOS 菜单栏应用，实时显示 Claude 与 Codex 剩余配额

vladamarkov/kvotar

AI 导读

Kvotar 是一款原生 macOS 菜单栏应用，可显示 Claude Code 和 Codex 的剩余配额，并估算当前用量能否撑到配额重置。它读取本机已有的登录凭证，无需输入密码或 API key，支持 Homebrew 安装，要求 macOS 14 Sonoma 或更新版本。所有用量历史仅保存在本机，不含分析、遥测或崩溃上报。

正文

Will your quota last until reset?

Kvotar is a native macOS menu-bar app that shows your remaining Claude and Codex quota and estimates whether it will last until reset. See the readings behind its answer, get a warning while you work, and understand where your local tokens went.

Download the beta · Getting started · Documentation · Changelog

macOS 14 Sonoma or newer · Apple Silicon and Intel · No Kvotar account required

Works with Claude Code, Codex, or both.

A macOS menu bar with the Kvotar item beside the Wi-Fi, battery and clock: an amber dot, CL 32% with a reset in 1h05m, and a green CX 58%. Below it, Kvotar's Claude popover: 32% of the 5-hour quota left, the amber verdict 'Won't make it — slow down or you'll stop in ~38m', stops ~7:53 pm, resets 8:20 pm, runway ~38m, the quota burn of 0.84% per minute, and the weekly quota at 69% left.

Install

  1. Download the current beta.
  2. Unzip it and drag Kvotar.app into Applications.
  3. Open Kvotar.

Or with Homebrew: brew install --cask vladamarkov/tap/kvotar. Kvotar still updates itself; see the tap's notes for how it and brew upgrade interact.

Release builds are signed and notarized. Kvotar checks for updates daily and installs an update only when you click Install. You can turn off daily checks in the right-click menu.

Getting started

Kvotar uses the sign-ins your tools already have on this Mac. You do not enter a password or API key into Kvotar.

Tool What you need What Kvotar shows
Claude Code Claude Code signed in with your subscription Account limits and resets, usage credits where available, and local Claude Code activity
Codex Codex signed in with your ChatGPT account Account limits and resets, credits or monthly limits where available, and local Codex activity

The limits shown depend on what your provider reports for your plan. Kvotar follows one account per tool: the account currently signed in on this Mac. It does not track API-key billing.

  • Look for CL and CX in the menu bar. These are Claude and Codex. The percentage is quota left; the time shows a reset or an estimated time until it runs out.
  • Click to see the details. Hover over figures for explanations. Click an underlined pace verdict to see the readings and calculation behind it.
  • Right-click for settings. Choose notification groups under Notify me, enable Open at Login, or open History.

If a tool is not found, open it and sign in there. Kvotar detects its sign-in automatically. If you cannot find the menu-bar item, open Kvotar again from Applications to bring up its window.

How Kvotar helps

  • Keep your limits in view. The menu bar shows quota left and a reset or runway clock. Open the popover for the account's other limits: weekly, monthly and per-model, where available.

  • Get time to react. Pace estimates and optional notifications help you notice when usage may exhaust a limit before reset, so you can decide whether to slow down or defer work.

    A macOS menu bar with the Kvotar item beside the Wi-Fi, battery and clock: green dots, CL 62% with a reset in 1h52m, CX 58% with a reset in 2h04m.

    Nothing to think about. Both tools green, quota left and the reset clock in one glance, so you keep working without opening anything.

    The same menu bar with the Kvotar item showing an amber dot and one line: CL, a warning sign, wk 30%.

    The week is the problem. The 5-hour number can look fine while the weekly limit runs ahead of its week. A short reminder names it, so you can defer the heavy work before the week runs out.

    The same menu bar with a red dot: CL 4% and a runway of about 11 minutes; Codex still green at 58%.

    You will hit the wall before the reset. At this pace Claude stops in about 11 minutes, so finish the thought rather than start the big refactor.

    The same menu bar with a red dot: CL, a warning sign, wk 0% and a reset in 3 days; Codex still green at 58%.

    Blocked, and when you are back. The weekly is spent and work resumes in three days, while Codex still has room. No guessing, and no retyping a prompt into a tool that will refuse it.

  • Understand the answer. The explanation behind a pace verdict shows the figures and comparison that produced it.

    The same popover with the explanation pinned under the verdict: remaining 32% of window, burn 0.84% per minute over the last 9 minutes, runway ~38m so it stops ~7:53 pm, reset at 8:20 pm which is 1h 5m away, pace 68% used at 60% of the window. Below the rows: 'At this speed you run out in about 38m — before the reset, which is 1h 5m away', and the pace at which the verdict would change.

  • Catch up after a break. When there is a meaningful change, a line at the top of the tab tells you what changed since your previous look.

  • Understand where your tokens went. Today's local activity shows projects and models, token counts and estimated value at published API prices.

    The popover's local activity for today: Claude Code, 49.3M tokens in 6 sessions, a recent local rate of about 422 tokens per minute and a 97% cache hit. Top projects by observed tokens: kvotar, 49.3M, split into opus-5-5 at 35.6M and fable-5-1 at 13.6M. Estimated value at published API rates: $34.50 today, $162.59 over 7 days, $1685.00 over 30 days.

  • Look back at your week. History brings together a weekly recap, quota history, local usage breakdowns and recorded hard blocks, across a 30-day view.

Illustrative example: You have about 40 minutes of estimated runway, but the limit resets in 1 hour 52 minutes. If that limit blocks further requests, continuing at the same pace could leave you waiting about 72 minutes. An early warning gives you time to adjust. Runway changes with usage; it does not predict when your task will finish.

History answers questions such as: Which projects used the most tokens? How much quota was left at reset? When did I hit a limit? Weekly recaps cover completed Monday–Sunday weeks and link to the records behind their observations.

Understanding the numbers

Account quota and local activity have different coverage. The provider's quota can include usage elsewhere on the account. Local breakdowns cover only the activity recorded on this Mac.

Runway needs enough readings. Kvotar estimates it from recent quota changes. A missing estimate does not mean you have unlimited quota.

Estimated token value is not your bill. Published API prices put local token use in perspective; the result is not your subscription charge, actual spending or money saved.

History depends on what was recorded. Local usage can be recovered from existing session logs. Quota history builds while Kvotar is running. The 30-day view is a reporting period, not a data-deletion schedule. See storage and retention.

Privacy

Your usage history stays on your Mac. Kvotar has no analytics, telemetry or crash reporting.

  • Kvotar reads your existing credentials. It never writes to the Keychain or your tools' sign-in files, never refreshes a token, and never asks another program to refresh one.
  • Session logs provide token counts, model names, timestamps and project folders. Kvotar never stores your prompts, code, transcripts or tool output, and never copies the session files.
  • Kvotar keeps its own data in ~/Library/Application Support/Kvotar and its logs in ~/Library/Logs/Kvotar.

Network use is limited to your providers' services, update checks, and links you choose to open. Claude quota comes from api.anthropic.com; Codex quota comes through the local codex app-server, with chatgpt.com as a fallback. Update checks go to updates.kvotar.com: they include the app version, and the server sees your IP address and the request time. Your usage is not uploaded.

Save Diagnostics… creates a zip on your Desktop and sends nothing. Even an ordinary bundle contains logs with local folder paths. Extended diagnostics require your consent for up to 24 hours; an extended bundle includes a copy of the database with account details and usage history. Review a bundle before sharing it, and never attach one to a public issue.

Read credentials and privacy for the full data, network and diagnostics details, including how to remove Kvotar's data.

Help

Claude sign-in expired? Open Claude Code so it can renew its own sign-in. If Claude Code asks you to sign in again, do that there. Kvotar picks up the renewed credential on a later check.

Looking for settings or the welcome walkthrough? Right-click the menu-bar item. In the Kvotar window, the ⋯ button opens the same menu. Choose Welcome to Kvotar… to revisit the walkthrough.

Missing hard blocks in History? Kvotar records these through its Notify me → Over quota group. Blocks that happened while that group was off are not recorded there.

Documentation

Read more about Where
What Kvotar reads, keeps and sends Credentials and privacy
Changes in each version Changelog
Scope and project direction Vision
Detailed behavior and known gaps Specification index
Code structure Architecture
The separately built command-line tool CLI reference

Build from source

You need Xcode 26 with Swift 6.2 and XcodeGen. Xcode 26 requires macOS 15.6 or newer; the app you build runs on macOS 14 or newer.

git clone https://github.com/vladamarkov/kvotar.git
cd kvotar
brew install xcodegen
make build   # builds an unsigned app and prints its path
make run     # builds a debug copy and launches it in place of a running Kvotar
make test    # runs package and app tests on synthetic fixtures
make check   # checks static rules and documentation paths

These commands need no Claude or Codex account. make run runs your build on your own Mac: it shares an installed Kvotar's sign-ins and data and leaves the copy in Applications untouched (details). The app build does not include the separate CLI.

Contributing

Kvotar is developed in this repository, and pull requests are welcome. CONTRIBUTING.md explains how a change lands, and AGENTS.md has the rules every change follows.

License and affiliation

The code and artwork are licensed under the Apache License 2.0. The name Kvotar is reserved for official releases: a distributed fork needs its own name, icon and menu-bar mark. See TRADEMARK.md. Third-party licenses are in Resources/THIRD_PARTY_NOTICES.

Kvotar is an independent project, not affiliated with, endorsed by or sponsored by Anthropic or OpenAI. Claude and Claude Code are trademarks of Anthropic; Codex and ChatGPT are trademarks of OpenAI.

来源：GitHub · github.com

Anthropic / ClaudeOpenAI / ChatGPT开源生态部署工程产品更新#产品更新#开源/仓库#部署/工程#Anthropic#OpenAI