convez.ai
PluginUtilidadesIntermediário
zhiluo20

Quotient

zhiluo20/Quotient

Monitor de quota em LED para Codex, Claude e Gemini no macOS

Ver no GitHub
InicialPluginScore · de 0 a 100

Widget nativo para macOS que exibe em tempo real o uso de cota de serviços locais (Codex, Claude Code, Gemini) através de LEDs em semáforo (verde/amarelo/vermelho). Combina um painel flutuante com efeito vidro líquido e widgets WidgetKit para desktop, permitindo monitorar múltiplos serviços simultaneamente sem abrir terminal.

Instalação

$npx convez-ai zhiluo20/Quotient

1 comando no terminal: detecta o formato do repositório (marketplace ou plugin avulso) e instala via Claude Code. Requer Node 18+ e o Claude Code instalado.

Métricas

Estrelas
0
Forks
0
Acompanhando
1
Saúde
42%
Último commit
há 4 meses
Versão
v1.0.3
Issues abertas
0
Contribuidores
1

Casos de uso

  • Monitorar consumo de API localmente durante desenvolvimento
  • Visualizar status de múltiplos serviços no desktop sem comando CLI
  • Gerenciar widgets independentes por serviço em diferentes áreas da tela

Veredito

Solução elegante e prática para quem trabalha com Codex/Claude Code no macOS e precisa monitorar quotas sem interrupções. Bem pensada em privacidade (lê dados locais offline) e oferece flexibilidade real com widgets independentes.

README

A tradução para o português deste README ainda está na fila.

Quotient

English · 简体中文

A macOS desktop widget that shows the remaining quota of your local Codex, Claude Code, and Gemini as red / yellow / green LEDs — so you can tell your usage at a glance without opening a terminal. At most two services are shown at once, and each desktop widget can be configured independently — so you can place several widgets, each showing different services.

Screenshots

Liquid-glass floating panel — pin on top, drag anywhere; controls appear on hover (pin / settings / refresh / hide / quit):

Native desktop widget — sits on the desktop like Calendar or Weather; in full-color mode the LEDs and bars are tinted by remaining quota:

In the desktop monochrome (frosted) mode, bars automatically switch to an opacity-contrast scheme so they stay readable:

Widget gallery — right-click the desktop → "Edit Widgets" → search "Quotient"; small and medium sizes are available:

Features

  • 🟢 Traffic-light quota — green when ≥ 10% remains; yellow when 0 < remaining < 10%; red at 0.
  • 🪟 Liquid-glass panel — native macOS 26 Liquid Glass (glassEffect), with the same two-column layout and corner radius as system widgets; draggable, position remembered.
  • 📌 Pin / hide — the pin button toggles always-on-top; the ➖ button hides the panel, and you can restore it anytime from the menu-bar LED menu (the dot's color is the overall quota state).
  • ⚙️ Standard menu & settings — the menu-bar menu has "About Quotient" (standard About panel: version, author Zhi Luo, built with the help of Claude Code) and "Settings…". Options:
    • Show services (max two): Codex only / Claude only / Gemini only, or Codex+Claude / Codex+Gemini / Claude+Gemini — this is the floating panel's setting and also the default for new widgets;
    • Language: match system (default) / 简体中文 / English.
  • 🧩 Per-widget configuration — each desktop widget has its own service selection via the native "Edit Widget" picker (long-press / right-click a widget → Edit Widget → Services). Leave it on "Default (app setting)" to follow the panel, or pick a specific service / pair. Place multiple widgets, each showing different content.
  • 🔄 Auto refresh — Codex is read from local files every minute; Claude / Gemini are fetched every 5 minutes. It refreshes again right after each reset time, and windows past their reset show as 100%. When the Claude / Gemini access token expires, it is silently refreshed via the local refresh token (no re-login). When offline, the last result is kept and tagged with its "as of" time.
  • 🔐 Privacy-friendly:
    • Codex quota comes from the rate_limits snapshots the CLI itself records in ~/.codex/sessions/**/rollout-*.jsonl — fully offline, never touching auth.json.
    • Claude quota reuses Claude Code's existing login (keychain Claude Code-credentials or ~/.claude/.credentials.json) and calls Anthropic's official api.anthropic.com/api/oauth/usage endpoint.
    • Gemini quota reuses Gemini CLI's login (~/.gemini/oauth_creds.json) and calls Code Assist's retrieveUserQuota endpoint (the same source as Gemini CLI's /status), showing the remaining fraction per model family (Pro / Flash / Flash-Lite).
    • All tokens are used in memory only, for the quota requests and token refresh; after refresh they are written back to their original store to stay in sync with each CLI — never saved elsewhere, never displayed, never sent to any third party.

Two display forms

  1. Liquid-glass floating panel (the host app itself): pinnable, refreshes by the minute, controls appear on hover.
  2. System desktop widget (WidgetKit extension): right-click the desktop → "Edit Widgets" → search "Quotient"; small and medium sizes, usable on the desktop and in Notification Center. Each instance is independently configurable (Edit Widget → Services). In desktop monochrome rendering mode, bars switch to an opacity-contrast scheme.

The host app fetches all data and writes it to an App Group container (snapshot.json — percentages and reset times only, never any credentials), then asks the system to reload the widget. While the host app runs, the widget is near-real-time; after the host quits, the widget refreshes on the system budget (~15 min) and turns green automatically at reset times. Adding the host app as a login item is recommended.

Install (from a release)

  1. Download Quotient-x.y.z.dmg from Releases.
  2. Open the DMG and drag Quotient into Applications.
  3. First launch only: right-click Quotient.app → Open → Open in the dialog. (Or, if macOS blocked it, go to System Settings → Privacy & Security, scroll down, and click Open Anyway.)

This one-time step is needed because the app is not notarized (see below) — after the first open, it launches normally like any other app.

Why the right-click? The app is signed only for development, not with a paid Developer ID + Apple notarization, so Gatekeeper asks you to confirm it once. This is normal for open-source apps distributed outside the App Store. Public "double-click just works" distribution would require a paid Apple Developer account ($99/yr): a Developer ID Application certificate plus xcrun notarytool notarization. This is not the same as the App Store — the DMG itself never goes through App Store review.

Build

Requires macOS 15+, Xcode, XcodeGen (brew install xcodegen), and an Apple Development signing certificate (the widget extension must be genuinely signed; the Team ID goes in project.yml and the App Group ID in Snapshot.swift — note the Team ID is the certificate's OU field, not the name in parentheses; replace it with your own Team ID when cloning). Liquid Glass requires macOS 26.

./build.sh                # builds dist/Quotient.app and packages dist/Quotient-x.y.z.zip
./Scripts/make_dmg.sh     # packages dist/Quotient-x.y.z.dmg (drag-to-Applications)
./Scripts/make_icon.sh    # (optional) regenerate Resources/AppIcon.icns
open dist/Quotient.app

The app runs without a Dock icon (a menu-bar LED menu is provided); quit from the menu or the panel's ✕. The widget is registered in the gallery only after the first launch.

Acknowledgements

Inspired by xicunwus2025-sys/codex-led-widget — the traffic-light quota idea comes from that project.

License

MIT © 2026 Zhi Luo

Project layout

Sources/
  Shared/   models, bilingual strings, Codex/Claude/Gemini readers, shared views, snapshot
  App/      floating-panel host (NSPanel + menu-bar menu + settings window + refresh scheduler)
  Widget/   WidgetKit extension (AppIntent config + AppIntentTimelineProvider + small/medium views)
Scripts/    icon generation script
Resources/  AppIcon.icns
project.yml XcodeGen project definition (two targets, entitlements, App Group)
Ver o original no GitHub

Bom para

Relacionados