ericjypark

Codex Island — AI skill for Claude Code

AI community

CodexIsland - AI usage limits in your MacBook notch.

How to install Codex Island

This entry records only its repository, not the path inside it, so there is no exact command to give. Open ericjypark/codex-island and copy the folder into ~/.claude/skills/, or the file into ~/.claude/agents/.

What Codex Island does

CodexIsland - AI usage limits in your MacBook notch.

Alternatives in AI

  • Codeburn — Free, local tool to track AI coding token usage and cost across 37 tools and agents (Claude Code, Cursor, Code 9.7k ★
  • CodeIsland — Real-time AI coding agent status panel in your MacBook notch — live status, approvals & replies for 13 AI tool 2.3k ★
  • Claude Usage Tracker — Native macOS menu bar app for tracking Claude AI usage limits in real-time 2.2k ★

README

CodexIsland

[English](README.md) | [简体中文](README.zh-CN.md)

CodexIsland logo

README visitors

Your AI usage limits, living in your notch.

CodexIsland is a native macOS overlay that turns the MacBook notch into a Dynamic-Island-style live activity for Claude Code and Codex usage limits. It sits quietly over the notch, peeks on hover with the 5-hour headline, and expands on click to show both providers' 5-hour and weekly windows with reset timing, chart controls, local-log cost estimates, and a year-at-a-glance usage history.

https://github.com/user-attachments/assets/195beeff-0f70-4d6b-8f3d-9f31d9c0b989

The app is free, open source, unsigned, and local-first. It reads credentials already written by Claude Code / Claude Desktop and Codex, then calls only the providers' own usage endpoints.

What it does

  • Two providers, four windows. Claude 5h + 7d and Codex 5h + 7d live in one panel.
  • Notch-native overlay. The compact state is a black pill aligned to the physical notch, drawn with continuous (squircle) corners that match the hardware. On non-notched displays it falls back to a configurable menu-bar pill.
  • Hover to peek. The silhouette widens just enough to show each visible provider's 5-hour percentage and reset headline, or keep those headlines visible at rest with Always show usage.
  • Three swipeable screens. Click to expand, then swipe between Usage, Cost, and Overview. Cost estimates today and month-to-date spend and token throughput from local Claude Code, Codex CLI, and OpenCode session data. Overview renders the current year's activity as a contribution-style calendar using logs from every suppor