Codexling

macOS status bar app concept for viewing Codex usage limits through the official Codex/ChatGPT login flow.

Documents

• 方案文档
• ChatGPT Plus/Pro 会员到期调研
• 最新 UI 全量升级实施方案
• 实现待办

Build

cd app/Codexling
./package_app.sh
open "dist/Codexling.app"

Release packaging and GitHub publishing are handled by the interactive script:

cd app/Codexling
./release_app.sh

See 发布脚本说明.

状态栏任务圆灯、额度背景、Codex 内置 Pet 发现与活动状态映射见 状态栏与 Pets 方案。

主弹窗、设置页与分离窗口的浅色/暗色玻璃实现见 流体玻璃主题。

If swift build asks for the Apple SDK license, run this once in Terminal:

sudo xcodebuild -license

Current Flow

1. Click the menu bar summary.
2. Click the login/fetch icon or the refresh button.
3. The app starts the same OAuth PKCE flow used by Codex usage, opens the official OpenAI authorization page, and listens on http://localhost:1455/auth/callback.
4. After authorization, the app stores the OAuth token in Keychain and fetches Codex usage from https://chatgpt.com/backend-api/wham/usage.
5. Reset credits are fetched from https://chatgpt.com/backend-api/wham/rate-limit-reset-credits.
6. The latest successful snapshot is cached locally for fast menu bar startup.

Product Goal

Show Codex short-window and weekly usage in the macOS menu bar, and provide a click-to-open detail panel with credits, reset coupons, expiration times, and the latest refresh status.

The app should use official OpenAI/Codex web login only. It should not store account passwords, bypass MFA, or depend on private account credentials.