Summary

codexU is a macOS menu bar and desktop application for developers using OpenAI Codex and Claude Code. It provides local monitoring of API quotas, token usage, and daily tasks, offering a centralized, quick-access view to manage AI development workflows efficiently without needing browser or terminal windows.

How It Works

The application reads data locally from ~/.codex/ and ~/.claude/, integrating with OpenAI's app-server API for account/quota info and local files for detailed token usage. It dynamically adapts its UI (quota rings, progress bars) based on API responses and offers customizable status bar displays with power-saving rendering options. A key feature is the "Wool Progress" metric, estimating monthly API equivalent value of token usage against subscription tiers using a non-linear scale. Claude Code usage is tracked via local transcripts and optional cache snapshots.

Quick Start & Requirements

• Install: Download the appropriate DMG (*-mac-arm64.dmg or *-mac-x86_64.dmg) from GitHub Releases. Drag codexU.app to Applications. Manual security approval may be needed via System Settings > Privacy & Security.
• Requirements: macOS 13+, local Codex installation (used at least once), logged-in Codex account. Optional: Claude Code stats require local transcript data (~/.claude/).
• Links: Documentation available in RESEARCH.md and DISTRIBUTION.md. GitHub Releases is the implied source for downloads.

Highlighted Details

• Adaptive UI: Dynamically adjusts quota display (rings, bars) based on API responses.
• "Wool Progress" Metric: Estimates monthly API equivalent value of token usage in USD against subscription tiers.
• Local Data Focus: Processes all usage, quota, and task data strictly locally for privacy.
• Customizable Interface: Offers multiple UI themes, status bar configurations, and keyboard shortcuts.
• Task Board Integration: Generates daily task boards from local Codex threads and automations.

Maintenance & Community

Maintained by shanggqm. Community interaction via user exchange group and WeChat official account (details provided via QR codes in the README). Automatic checks for new GitHub Releases and beta versions are included.

Licensing & Compatibility

• License: MIT License.
• Compatibility: Permissive license suitable for commercial use and integration into closed-source projects.

Limitations & Caveats

• Unofficial: Third-party, unofficial tool for macOS 13+.
• Data Representation: Codex quota shown as remaining percentages due to API limits; Claude Code usage based on local history/snapshots, not official billing.
• Permissions: Requires explicit file access permissions for local data reading.