git404hub

what is claudequota fr?

dickie2306/claudequota — explained in plain English

Analysis updated 2026-05-18

13SwiftAudience · developerComplexity · 2/5LicenseSetup · easy

tl;dr

A free macOS menu bar app that shows your live Claude AI usage limits, like session and weekly quotas, at a glance without opening a browser tab.

vibe map

mindmap
  root((ClaudeQuota))
    What it does
      Menu bar usage gauge
      Session and weekly limits
      Usage notifications
    Tech stack
      Swift
      macOS Keychain
      OAuth
    Use cases
      Track Claude usage
      Avoid hitting limits
      Auto sign-in via Claude Code
    Audience
      Claude subscribers
      macOS developers

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

what do people make with this?

VIBE 1

Keep an eye on your 5-hour Claude session usage from the macOS menu bar without visiting claude.ai.

VIBE 2

Get a notification when your Claude usage crosses 80 percent or 95 percent of your limit.

VIBE 3

Automatically connect using Claude Code's saved login if you already use Anthropic's coding tool.

VIBE 4

Check your current Claude plan and weekly per-model usage limits at a glance.

what's the stack?

SwiftmacOSKeychainOAuth

how it stacks up fr

dickie2306/claudequotaa9eelsh/heliocoreamfi-disable/juicer
Stars131313
LanguageSwiftSwiftSwift
Setup difficultyeasyhard
Complexity2/53/5
Audiencedeveloperdeveloperdeveloper

Figures from each repo's GitHub metadata at analysis time.

how do i run it?

Difficulty · easy time til it works · 5min

Requires macOS 13+, a Claude Pro or Max subscription, and Xcode Command Line Tools to build.

Use freely for any purpose, including commercial use, as long as you keep the copyright notice.

in plain english

ClaudeQuota is a small native macOS menu bar app that shows how much of your Claude AI usage limit you have used, the same numbers you would normally find by visiting the Claude website's usage settings page. A color coded ring gauge sits in the menu bar showing your current 5 hour session usage as a percentage, turning from green to orange to red as you use more of your limit. Clicking it opens a full breakdown covering the session limit, the weekly limit across all models, and limits for specific models, along with when each one resets. The app can sign in two ways. If you already use Anthropic's Claude Code coding tool and are logged into it, ClaudeQuota can read its stored login credentials from the Mac's Keychain and connect automatically with no setup. If you instead use Claude through the website or the desktop chat app, you sign in from the menu bar through your browser, and your username and password go only to Anthropic, never to this app. Once signed in, ClaudeQuota keeps its own separate login credentials and refreshes them on its own, and the README states it never writes to or modifies the Claude Code credentials it may have borrowed from, only reads them once. Other features include one-time notifications when your session usage crosses 80 percent and 95 percent, an automatic refresh every 3 minutes with backoff if Anthropic rate limits requests, detection of your current Claude plan, and an option to start automatically at login with no Dock icon. It requires macOS 13 or later, a Claude Pro or Max subscription, and Xcode Command Line Tools to build it from source, since it is a single Swift file with no external dependencies. The README notes it relies on an undocumented Anthropic API endpoint that could change without warning, and that the app shows the last known data if it cannot reach the network. It is described as an unofficial, personal-use tool not affiliated with or endorsed by Anthropic. It is licensed under the MIT License.

prompts (copy fr)

prompt 1
Walk me through cloning and building ClaudeQuota with build.sh on my Mac.
prompt 2
Explain the difference between signing in through Claude Code credentials versus browser sign-in.
prompt 3
Help me set up a self-signed certificate so Keychain approval survives rebuilds.
prompt 4
Show me where to change the poll interval and notification thresholds in Sources/main.swift.

Frequently asked questions

what is claudequota fr?

A free macOS menu bar app that shows your live Claude AI usage limits, like session and weekly quotas, at a glance without opening a browser tab.

What language is claudequota written in?

Mainly Swift. The stack also includes Swift, macOS, Keychain.

What license does claudequota use?

Use freely for any purpose, including commercial use, as long as you keep the copyright notice.

How hard is claudequota to set up?

Setup difficulty is rated easy, with roughly 5min to a first successful run.

Who is claudequota for?

Mainly developer.

peek the repo → explain another one

This repo across BitVibe Labs

double-check against the repo, no cap.