codexisland-macos-notch

Installation
SKILL.md

CodexIsland macOS Notch

Skill by ara.so — Codex Skills collection.

CodexIsland is a native macOS overlay that transforms your MacBook notch into a Dynamic Island-style live activity display for Claude Code and Codex usage limits. It shows 5-hour and weekly usage windows for both providers, estimates dollar spend and token throughput from local session logs, and provides a swipeable Cost screen—all while remaining local-first and credential-free.

What CodexIsland Does

  • Dual-provider monitoring: Tracks Claude (5h + 7d) and Codex (5h + 7d) usage limits in one notch overlay
  • Notch-native overlay: Black pill aligned to the physical notch with squircle corners; falls back to menu-bar pill on non-notched Macs
  • Hover to peek: Shows 5-hour percentage and reset headline for visible providers
  • Click to expand: Opens full Usage/Cost panel with provider columns and chart controls
  • Swipeable screens: Usage screen (live limits) + Cost screen (local log analysis for $ spend & tokens)
  • Five chart styles: Ring, Bar, Stepped, Numeric, Sparkline
  • Local-first privacy: Reads existing credentials from Claude Code/Codex; no API keys stored; no telemetry

Installation

Homebrew (Recommended)

Installs
80
First Seen
May 20, 2026
codexisland-macos-notch — aradotso/codex-skills