ericjypark

ericjypark / codex-island

Public

CodexIsland - AI usage limits in your MacBook notch

codexisland.com claude claude-code codex macos notch
12
0
100% credibility
Found May 05, 2026 at 12 stars -- GitGems finds repos before they trend. Get early access to the next one.
Sign Up Free
AI Analysis
Swift
AI Summary

CodexIsland is a free macOS overlay app that displays real-time usage limits and local log-based cost estimates for Claude and OpenAI Codex AI services in a Dynamic Island-style notch widget.

How It Works

1
🔍 Discover CodexIsland

You stumble upon this clever little app that turns your MacBook's notch into a live display for your AI usage limits.

2
📥 Install the app

Grab the app from the releases page or use a quick install command, then drag it to your Applications folder and allow it to run.

3
🚀 Launch and connect

Open the app – it automatically picks up your existing setups for Claude and Codex without needing any new logins or passwords.

4
👀 Peek your usage

Hover near the notch to see a quick pill showing your current 5-hour usage percentages and reset times for both services.

5
🖱️ Expand to explore

Click the pill to open a beautiful panel with colorful charts for short-term and weekly limits, then swipe to view spending estimates.

6
⚙️ Customize your view

Tap the gear icon to tweak refresh speed, chart styles, power saving, or even hide one service if you only use the other.

✅ Usage at a glance

Now your AI limits and costs live right in your notch, updating quietly so you stay productive without hitting surprise caps.

Sign up to see the full architecture

5 more

Sign Up Free

Star Growth

See how this repo grew from 12 to 12 stars Sign Up Free
Repurpose This Repo

Repurpose is a Pro feature

Generate ready-to-use prompts for X threads, LinkedIn posts, blog posts, YouTube scripts, and more -- with full repo context baked in.

Unlock Repurpose
AI-Generated Review

What is codex-island?

CodexIsland is a Swift-based macOS app that transforms your MacBook notch into a Dynamic Island-style live display for Claude Code and Codex usage limits. It shows 5-hour and weekly rate limits at a glance—hover to peek percentages and reset times, click to expand charts, and swipe to a cost screen estimating dollar spend and token throughput from local session logs. No extra auth needed; it reads credentials from your existing CLI tools and calls provider endpoints directly.

Why is it gaining traction?

It nails the notch form factor with squircle corners matching hardware, click-through outside the silhouette, and smooth hovers/expands without Dock icons or telemetry. Standout hooks include five chart styles (ring to sparkline), on-demand refreshes every 5-30 minutes to dodge rate limits, and local cost bucketing for today/month in USD, tokens, or value vs. your Pro/Max plan—all configurable via a gear menu. Free, unsigned builds via Homebrew or DMG, with Sparkle auto-updates.

Who should use this?

MacBook Pro/Max users grinding Claude Code or Codex CLI sessions, especially those hitting 5-hour walls mid-flow and tired of browser tabs for usage checks. Ideal for AI-heavy devs tracking spend without context-switching, or teams monitoring token budgets on shared machines.

Verdict

Grab it if you're in the niche—polished UX punches above 12 stars, with solid README install guides and MIT license. 1.0% credibility reflects early maturity (unsigned, undocumented endpoints), so audit source before production; test on Ventura+ first.

(187 words)

Sign up to read the full AI review Sign Up Free

Similar repos coming soon.