CodexPulse

简体中文 · English

CodexPulse is a tiny, native macOS menu bar monitor for Codex. It shows live task activity and remaining Codex quota without requiring you to open the app.

The pixel display changes as Codex changes:

>_ 42%   red: Codex is working
>_ 42%   green: Codex is idle

Features

• Live Codex activity in the menu bar
• Remaining Codex quota and reset time
• A compact 5×7 pixel display with synchronized status colors
• Current local task names in the popover
• Automatic system-language selection
• English, Simplified Chinese, Japanese, Korean, and French
• Native SwiftUI/AppKit implementation with no third-party dependencies
• No analytics or telemetry

Codex-Spark uses a separate quota pool. CodexPulse intentionally hides that pool and displays the primary Codex quota only.

Requirements

• macOS 13 or later
• The Codex desktop app installed in /Applications/ChatGPT.app, or a codex executable in /usr/local/bin or /opt/homebrew/bin
• A signed-in ChatGPT-backed Codex session for quota data

Task activity is read from local Codex task metadata. Quota data comes from the official local codex app-server account interface. API-key-only sessions may not expose ChatGPT quota data.

Install

1. Download the latest CodexPulse ZIP from GitHub Releases.
2. Extract CodexPulse.app.
3. Move it to /Applications.
4. Open CodexPulse. It runs only in the menu bar and does not add a Dock icon.

Build from source

Xcode 15 or later is recommended.

git clone https://github.com/scoinmind-oss/CodexPulse.git
cd CodexPulse
zsh scripts/build-app.sh
open outputs/CodexPulse.app

The build uses an ad-hoc local signature. Distribution through the Mac App Store or notarized releases requires your own Apple Developer signing setup.

Localization

CodexPulse follows the macOS preferred language order automatically. Included localizations:

• English (en)
• Simplified Chinese (zh-Hans)
• Japanese (ja)
• Korean (ko)
• French (fr)

Translations live in Resources/<language>.lproj/Localizable.strings. Contributions for additional languages are welcome.

Privacy

CodexPulse reads only the local Codex task database and rollout files needed to determine whether a task is active. It starts the bundled Codex app server to read account quota information. It does not collect analytics, upload task content, or store credentials.

License

MIT