GlassQuota is a native macOS menu bar app that displays real-time remaining usage for Codex and Gemini entirely from local data.

Stars

42

7-day growth

No data

Forks

2

Open issues

0

License

MIT

Last updated

2026-08-01

AI repository intelligence
FR-AI / ANALYSIS

Why it is worth attention

It turns rate-limit information that is usually hidden in logs or app screens into an at-a-glance menu bar widget, with a polished glass UI and a privacy-friendly local-only design.

Who it is for

  • Developers who use Codex CLI and want to monitor remaining usage
  • Gemini app users who need to track weekly quota without opening the app
  • macOS users who prefer native, privacy-focused menu bar utilities
  • Swift developers interested in combining menu bar UI with macOS accessibility APIs

Use cases

  • Checking remaining Codex usage at a glance while coding
  • Monitoring Gemini weekly usage limits without manually navigating the app
  • Avoiding unexpected rate-limit interruptions during long work sessions
  • Auditing usage data locally without uploading account information

Strengths

  • Local-only data access: no upload of account, conversation, token, or usage data
  • Codex refreshes every 5 seconds for current status
  • Gemini usage is cached, retried on failure, and hidden when the app is not running
  • Native Swift implementation with a liquid glass menu bar panel and progress indicators

Considerations

  • Requires macOS 15 or newer and Swift 6
  • Gemini support requires the official Gemini macOS app and Accessibility permission
  • It is an unofficial community project with no affiliation or endorsement from OpenAI or Google

README quick start

GlassQuota

GlassQuota 是一个原生 macOS 菜单栏工具,实时显示 Codex 与 Gemini 的剩余用量。

功能

  • 菜单栏显示 Codex、Gemini 图标与剩余百分比
  • 液态玻璃面板、进度条和安全等级圆环
  • Codex 每 5 秒刷新
  • Gemini 自动读取、缓存秒显、失败重试;未运行时自动隐藏
  • 所有用量数据仅在本机读取

要求

  • macOS 15 或更高版本
  • Swift 6
  • 已登录的 Codex
  • Gemini 官方 macOS 应用(可选)

运行

git clone https://github.com/chen10191200-hue/GlassQuota.git
cd GlassQuota
swift run -c release

使用 Gemini 时,请在“系统设置 → 隐私与安全性 → 辅助功能”中允许 GlassQuota。应用会自动打开 Gemini 的“用量限额”页读取可访问性文本,随后关闭该窗口并恢复之前的应用。

数据与隐私

  • Codex:读取本机 ~/.codex/sessions 中最新的速率限制事件。
  • Gemini:通过 macOS 辅助功能读取 Gemini 应用显示的当前与每周限额。
  • 不上传账号、对话、Token 或用量数据。

说明

这是非官方社区项目,与 OpenAI 或 Google 无隶属或背书关系。Codex、OpenAI、Gemini、Google 及相关标志是其各自权利人的商标;MIT 许可证不授予任何商标权。

License

MIT

Description

Native macOS menu bar app for real Codex and Gemini quota.

Related repositories

Similar projects matched by category, topics, and programming language.

Blaizzy
Featured
Blaizzy GitHub avatar

nativ

Nativ is a native macOS app that lets you run AI models locally on Apple silicon, offering chat, model management, performance analytics, and an OpenAI/Anthropic-compatible API server.

AI & Machine LearningAI Vision & Audio
985
makecindy
Featured
makecindy GitHub avatar

cindy

Cindy is an open-source AI agent that runs locally on your machine, integrates multiple AI harnesses and models, and provides memory, skills, and automation to perform real work in your projects and apps.

AI & Machine LearningLarge Language Models
958
uzairansaruzi
Featured
uzairansaruzi GitHub avatar

hermex

Hermex is a native SwiftUI iPhone app that lets you control a self-hosted Hermes AI agent directly from your phone, with no subscriptions, tracking, or third-party relay.

AI & Machine LearningLarge Language Models
941