ericjypark/codex-island

CodexIsland - AI usage limits in your MacBook notch

What it solves

CodexIsland is a native macOS overlay that allows users to track their AI usage limits for Claude Code and Codex in real-time. It solves the problem of having to manually check usage quotas across different providers, integrating these metrics directly into the MacBook notch (or menu bar) for constant, low-friction visibility.

How it works

The app acts as a local-first overlay. It reads existing authentication credentials from the Claude Code and Codex command-line tools (such as ~/.codex/auth.json or macOS Keychain) and calls the providers' own usage endpoints. It does not store credentials itself, but it does maintain a local SQLite database to track token counts and usage history over time.

Who it’s for

Developers and power users of Claude Code and Codex who want to monitor their 5-hour and weekly usage windows, estimate API costs based on local logs, and visualize their long-term AI consumption patterns on macOS.

Highlights

  • Notch-native design: A Dynamic-Island-style overlay that matches the hardware notch, with a fallback for non-notched displays.
  • Multi-provider tracking: Monitors both Claude and Codex usage across 5-hour and 7-day windows.
  • Cost estimation: Calculates estimated spend and token throughput using local session logs from Claude Code, Codex CLI, and OpenCode.
  • Usage visualization: Includes a contribution-style calendar for yearly activity and shareable usage cards with cumulative charts.
  • Privacy-focused: No telemetry, no crash reporting, and no proxy services; all aggregation and rendering happen on-device.
  • Cusomizable alerts: Optional warning and critical thresholds that tint the island when limits are approached.

Related

  • Project
    shanggqm/codexU

    codexU is a native macOS/Windows dashboard that reads local Codex (and optional Claude Code) data to display quota, token usage, task status and a proprietary AI‑leadership score, all while keeping data on‑device.

  • Project
    sk-ruban/notchi

    Notchi is a macOS app that lives in the notebook’s notch and animates mascots in response to real‑time events from Claude Code or OpenAI Codex, optionally showing sentiment‑based emotions and tracking token usage.

  • Dispatch
    claude-quota: macOS Menu Bar Gauges for Claude Code Usage

    claude-quota is a SwiftBar plugin for macOS that provides real-time visual gauges in the menu bar to track Claude Code quota utilization across multiple accounts.

  • Project
    f-is-h/Usage4Claude

    A macOS menu bar app that tracks subscription usage limits for Claude and Codex, providing real-time quota monitoring and notifications.

  • Project
    wxtsky/CodeIsland

    A macOS application that turns the MacBook notch into a live status bar for AI coding agents, allowing users to monitor and approve tool calls without switching windows.