About Agent Island
Agent Island is a free, MIT-licensed status companion for Claude Code and Codex running locally on macOS and Windows. It provides live session state monitoring directly from your menu bar, alerting you when your turn is needed. All session data is processed on your machine, ensuring privacy and no telemetry.
Key Features
Live Session State
Monitors the real-time status of your local coding agent sessions, clearly indicating when a run is in progress, waiting, or requires your immediate attention.
Menu Bar Status Icon
A dynamic icon resides in your menu bar, rotating to visually confirm that your coding agent session is actively working, providing an at-a-glance status update.
Local and Private Monitoring
Agent Island operates entirely on your local machine, reading your disk for session data and processing it without uploading any information or requiring an Agent Island account or product telemetry.
Native macOS and Windows Support
Enjoy a seamless experience with native applications built for both macOS and Windows, integrating directly into your system's menu bar for unobtrusive monitoring.
Out of Your Way Design
Designed to be unobtrusive, Agent Island lives in your menu bar (or even the notch on macOS) with no dock icon or separate windows, ensuring it doesn't interfere with your workflow.
Weekly Report Card
Receive a comprehensive weekly summary including total tokens used with an estimated API value, a comparison of Claude vs. Codex usage, and your overall "island rank."
Use Cases
Monitoring Local Coding Agent Activity
Keep track of your Claude Code or Codex sessions without needing to constantly check your terminal or IDE, ensuring you know when your input is required.
Ensuring Privacy for Sensitive Work
For developers working with sensitive code or data, Agent Island offers peace of mind by processing all session information locally and never uploading any data.
Quick Status Checks on macOS/Windows
Instantly see if your coding assistant is busy or waiting for you directly from your menu bar, whether you're on a Mac or a Windows machine.
Understanding Your AI Usage
Gain insights into your token consumption and estimated API costs with the weekly report card, helping you manage your AI tool usage effectively.
Staying Informed Without Interruption
Agent Island's minimal design ensures it stays out of your way, providing essential status updates without adding clutter or distractions to your desktop.
Open Source Contribution and Transparency
As an MIT-licensed open-source project, users can inspect the code, contribute to its development, and trust in its transparent operation.
Frequently Asked Questions
What is Agent Island?
Agent Island is an open-source status companion for Claude Code and Codex on macOS and Windows. It provides live session state, your-turn alerts, and local monitoring without requiring an account or sending telemetry.
Does Agent Island run in the cloud?
No, Agent Island runs entirely on your machine. It reads local transcript files and calls official usage APIs with your existing local tokens. It does not require an account or send telemetry.
How do I install Agent Island?
On macOS, you can use brew install tristan666666/tap/agentisland or download the DMG. On Windows, download the win-x64 zip, unzip, and run AgentIsland.exe, or use winget install TristanTang.AgentIsland or Scoop.
Is Agent Island free and open source?
Yes, Agent Island is completely free and released under the MIT license, with all code available on GitHub.
Does Agent Island upload transcript content?
No, Agent Island processes local transcript and provider-state records on the device and does not upload transcript content. It also does not include Agent Island telemetry.
What information is included in the weekly report card?
The weekly report card includes the total tokens used with an estimated API value, a breakdown of Claude vs. Codex usage, 7-day usage bars, a TOP-3 model donut chart, and your island rank. The image is rendered locally and shared only when you choose.
