anshaneja5/claude-island

Claude Island shows how much of your Claude Code usage limit you have burned through, live in your iPhone's Dynamic Island. Claude Code's paid plans track usage in rolling five hour blocks, but there is no built in way to see where you stand mid session, since that data only lives in local logs on your Mac. This project pulls that number out and puts it somewhere you will actually notice it: the Dynamic Island, the lock screen, and a small dashboard app. The system works in three simple steps. A background job on your Mac reads your Claude Code logs every five minutes using a tool called ccusage, then writes a small file to a private GitHub gist. Your iPhone then checks that gist and displays the numbers as a Live Activity. There is no server to run, no account beyond GitHub and a free Apple developer id, and nothing to deploy. In the Dynamic Island you get a pixel mascot named Clawd that hops when new data arrives, a ring showing how much of your five hour block has been used, an odometer style cost counter that changes color as your spending heats up, a countdown to when the block resets, and quick stats on tokens used and dollars burned per hour. The app itself adds a fuller view: a current block card, a burn rate chart covering the last couple hours, a fourteen day history, and a breakdown of spend by model. Setup takes about five minutes. You need a Mac running Claude Code, an iPhone, Xcode, and a free Apple id. You create a GitHub token scoped only to gists, run an install script on the Mac that sets up the background job and gist, then build and install the iPhone app yourself through Xcode. Because a free Apple developer account is being used, the app needs to be rebuilt and reinstalled roughly once a week. The author is upfront that the displayed cost is based on list API pricing, not your actual subscription bill, and that updates arrive through polling rather than instant push notifications, since real time push would require a paid server setup that this project intentionally avoids.