burakgon/ai-usage-menubar

AI 仓库情报摘要

FR-AI / ANALYSIS

为什么值得关注

它在调度刷新之间 CPU 占用为 0%，直接读取本地 CLI 工具的 OAuth 凭据，采用原生 Liquid Glass 外观，并且完全不打扰用户。

适合谁使用

macOS 上的 Claude Code 重度用户
需要监控使用配额的 Codex 用户
偏爱轻量级、注重隐私的菜单栏工具的开发者
希望替代浏览器中笨重的使用追踪器的用户

典型使用场景

从菜单栏一眼查看剩余的 Claude Code 会话/周额度
无需打开浏览器或终端即可监控 Codex Spark 和周使用量
快速在提供方（Claude Code、Codex）、周期（会话/周）和显示模式（已用/剩余）之间切换
设置 1 至 60 分钟的自动刷新间隔，并接收一键更新通知

项目优势

原生 macOS 应用，刷新间隔之间 CPU 占用为零，无 Dock 图标或持久窗口
读取本地 OAuth 凭据，无需遥测、使用历史或外部服务器
支持多种额度类型（Claude Code 会话/周/Sonnet/Fable、Codex 会话/周/Spark/Spark 周），显示可配置
采用 MIT 许可证开源，通过 Sparkle 提供签名的自动更新，界面简洁（SwiftUI）

使用前须知

需要 macOS 26 或更高版本
当前版本为 ad‑hoc 签名，首次启动可能需要手动右键点击 → 打开
不支持仅 API 密钥的 Codex 认证（无法读取 ChatGPT 使用量）

README 快速开始

AI Usage

Claude Code and Codex limits, one click away. Native Liquid Glass. Measured at 0.0% CPU between scheduled refreshes.

A real native menu bar popover — no Dock icon or persistent window.

AI Usage shows the limits that matter and stays out of the way. No extra account, API key, local server, telemetry, usage history, or background log scanning.

Other usage apps stay heavy. AI Usage stays light.

Download

Open the DMG, drag AI Usage to Applications, and launch it. It appears in the menu bar rather than the Dock. macOS 26 or newer is required.

[!NOTE] Current public builds are ad-hoc signed because a Developer ID certificate is not available yet. If macOS blocks the first launch, right-click AI Usage in Applications and choose Open. Future updates are still protected by Sparkle's EdDSA signature.

What you get

Claude Code session, weekly, Sonnet, and Fable limits
Codex session, weekly, Spark, and Spark weekly limits
Remaining or used percentages, switchable directly in the panel
A selectable provider and session/weekly value directly in the menu bar
Configurable 1, 5, 15, 30, or 60-minute refresh and one-click manual refresh
Signed update checks at launch and daily, plus Check for Updates…
A direct Update button in the panel when a new version is available
Provider cards only for installed tools, with signed-out status kept visible
Native light and dark appearances with Liquid Glass
Launch at Login enabled by default and still user-controllable

Build from source

You need:

macOS 26 or newer
Xcode 27 or newer
Claude Code and/or Codex already signed in locally

Then:

git clone https://github.com/burakgon/ai-usage-menubar.git
cd ai-usage-menubar
./scripts/install.sh

The script builds a local Release version, installs it to ~/Applications/AI Usage.app, and opens it. AI Usage appears in the menu bar, not the Dock.

To run without the installer, open AIUsage.xcodeproj in Xcode and run the AIUsage scheme.

How it works

AI Usage reads the same local OAuth credentials already created by the claude and codex CLIs, then requests quota data directly from the providers' first-party endpoints.

Credentials stay on your Mac.
Tokens are never printed, logged, or sent anywhere else.
Temporary failures keep the last

项目描述

A tiny native macOS menu bar app for Claude Code and Codex usage limits.

ai-usage-menubar