Agent Island is a free, MIT-licensed open-source status companion for Claude Code and Codex that runs in the menu bar on macOS and Windows, showing live session state and usage counts without uploading any data.
What is Agent Island?
Agent Island is an open-source status companion for Claude Code and Codex on macOS and Windows. It reads the transcript files these tools already write to disk and calls the official usage APIs with the tokens already present locally, then displays live session state, usage countdowns, and your-turn alerts in the menu bar. The app is developed by tristan666666, distributed under the MIT license, and the entire codebase is public on GitHub. It has no Agent Island account requirement and no product telemetry.
Key Features
- Live status — A rotating menu-bar icon indicates a session is working; the bar also shows usage countdowns for both Claude Code and Codex sessions.
- Your-turn alerts — Alerts you when you need to respond, and the monitor distinguishes working, waiting, and stalled sessions.
- Weekly report card — A locally rendered image with total tokens, an API-value estimate, a Claude-vs-Codex faction duel based on your real usage split, 7-day bars, a TOP-3 model donut, and your island rank.
- Monthly report card — Includes a 24-week heatmap, streak, and island rank, all rendered locally.
- Local and private — Reads your disk, uploads nothing, and runs without any cloud dependency or telemetry.
- Out of your way — Lives in the notch on macOS (or menu bar), with no dock icon and no windows.
- Cross-platform — Native WPF release for Windows 10/11 and a macOS build; version 1.7.1 supports both.
- Secure updates — On macOS, Sparkle verifies an EdDSA signature before installing any update.
Who is it for?
- Claude Code and Codex users who want to see at a glance whether a session is working, waiting, or needs their input.
- Developers running long AI coding sessions who need to track usage countdowns to avoid hitting limits mid-task.
- Users managing token budgets who want weekly and monthly reports showing total tokens, API value, model split, and streaks.
- Teams that care about privacy who want a monitoring tool that reads local transcript files and calls official APIs without uploading data to a third-party account.
What can you do with it?
- Monitor active sessions: See live status and usage countdowns for both Claude Code and Codex directly from the menu bar, so you know when a background task is done or blocked.
- Review weekly usage: Generate a weekly report card with tokens, API cost estimate, and model donut, then share it by copying or sharing the locally rendered image.
- Track long-term trends: Use the monthly report's 24-week heatmap and streak to see your coding consistency and usage patterns.
- Compare Claude vs Codex: The faction duel on the report card shows your real usage split, helping you decide which tool to use for different kinds of work.
How does Agent Island work?
Agent Island runs entirely on your machine. It reads the transcript files that Claude Code and Codex already write to disk, and calls the official usage APIs using tokens you already have locally. On macOS, install it with one line: brew install tristan666666/tap/agentisland, or download the DMG from the latest GitHub release. On Windows, download the win-x64 zip, unzip, and run AgentIsland.exe.
Pricing
Agent Island is free and open source under the MIT license. There are no paid tiers, subscriptions, or hidden fees.
Pros and cons
- Pros: Free, open-source (MIT), no account or telemetry, works on macOS and Windows, renders usage reports locally, and supports both Claude Code and Codex.
- Cons: The macOS build is ad-hoc signed, so the first launch requires a right-click → Open; Windows support is limited to the native WPF build.
FAQ
Is Agent Island free?
Yes. Agent Island is free and open source under the MIT license. The full source code is public on GitHub, and there are no paid tiers or hidden costs.
Does Agent Island run in the cloud?
No. It runs on your machine, reads your local transcript files, and calls the official usage APIs with your local tokens. There is no cloud component, no account, and no telemetry.
Why does macOS warn me on first launch?
The app is ad-hoc signed because there is no paid Apple Developer account. The first time, you need to right-click and choose Open. After that, updates are verified by Sparkle using an EdDSA signature.
Is there a Windows version?
Yes. Agent Island v1.7.1 includes a native WPF release for Windows 10/11. You can download the AgentIsland win-x64 zip from the GitHub releases page, unzip it, and run AgentIsland.exe.
What information appears on the weekly report card?
The weekly report card shows total tokens with an API-value estimate, a Claude-vs-Codex faction duel set to your real usage split, 7-day bars, a TOP-3 model donut, and your island rank. The image is rendered locally and shared only if you copy or share it.
