ericjypark/codex-island

What it solves

CodexIsland provides a persistent, non-intrusive way for macOS users to monitor their AI usage limits for Claude Code and Codex. Instead of manually checking provider dashboards, users can see their 5-hour and weekly quotas at a glance via a native overlay that integrates with the MacBook notch.

How it works

The app acts as a native macOS overlay that reads existing authentication credentials from Claude Code, Claude Desktop, and Codex local files or the macOS Keychain. It then polls the providers' own usage endpoints to fetch current quota data.

It presents this information through a "Dynamic Island" style interface: a compact pill over the notch that expands on click to show detailed usage, cost estimates based on local session logs, and a year-at-a-glance activity calendar.

Who it’s for

Developers and power users on macOS who use Claude Code and Codex and want to track their token consumption, spending, and remaining quotas without leaving their workflow.

Highlights

• Notch-native design: Aligns with the physical MacBook notch, falling back to a menu-bar pill on non-notched displays.
• Multi-provider tracking: Monitors both Claude and Codex usage across 5-hour and 7-day windows.
• Local-first privacy: Reads credentials and session logs locally; no telemetry, proxy services, or third-party analytics.
• Cost estimation: Aggregates token throughput and spend from local Claude Code, Codex CLI, and OpenCode session data.
• Customizable visuals: Offers five different chart styles (Ring, Bar, Stepped, Numeric, and Sparkline) and configurable alert thresholds.
• Safe polling: Includes configurable intervals (5m, 15m, 30m) to avoid aggressive rate-limiting by providers.