Agent Island
Agent Island is a free, MIT-licensed status companion for developers who use Claude Code and Codex. It runs on macOS and Windows and keeps coding-session state visible in a compact desktop surface. Instead of leaving every terminal in the foreground, a developer can glance at the menu bar or status area to see whether a session is working, waiting for input, stalled, or finished.
Session state and alerts
Long-running coding tasks create an attention problem. A session may continue for minutes, pause for confirmation, or finish while the developer is reading documentation or reviewing another change. Agent Island reduces repeated terminal checking. Its your-turn alert calls attention when the session needs the developer. It does not approve commands, answer prompts, or replace the original terminal; it only makes the existing session state easier to notice.
The focused interface is useful when several sessions are open at once. A developer can distinguish ongoing work from a session that requires input without rearranging windows. Agent Island is not a coding model, visual workspace, task manager, or project-management platform. It is a deliberately small status layer for tools developers already use.
Usage and local summaries
Agent Island includes usage views for supported provider information. For Claude it can present the five-hour window and weekly usage. For Codex it presents weekly usage rather than claiming a Codex five-hour window. Reset cards help developers understand when tracked windows are expected to reset. Used and remaining views make the same information easier to read for different planning habits.
Local session records can also be summarized into token activity, estimated cost, and model distribution. Weekly and monthly report cards turn selected local information into a compact view when the user chooses to review or share it. Cost figures are local estimates, not provider invoices, and provider billing pages remain authoritative.
Privacy and open source
Agent Island has no product account requirement, no product telemetry, and no Agent Island transcript-upload service. Session monitoring, usage summaries, and cost calculations use information available on the device. Claude Code and Codex retain their own provider connections and policies; Agent Island's privacy claim is narrower: the companion does not add a separate analytics cloud for session data.
The project is open source under the MIT License. Source code, issues, and releases are public at https://github.com/tristan666666/agent-island. Developers can inspect how the companion reads local state, review changes, report defects, and download releases without relying on a closed distribution portal.
Platforms and workflow
On macOS, Agent Island can live in the menu bar and use a notch-oriented presentation on compatible hardware. On Windows it provides the corresponding desktop status experience for the supported release. Platform presentation can differ while the purpose remains the same: show Claude Code and Codex state, surface usage context, and notify the developer when attention is needed.
A typical workflow starts in the normal terminal. The developer runs Claude Code or Codex, then moves to documentation, an editor, a review, or another task. Agent Island updates its local status surface. When the run finishes or needs input, the developer returns to the original terminal, reviews the result, and decides the next action.
Getting started
Visit https://agent-island.dev for the official overview and download links. Current macOS and Windows assets are also published through GitHub Releases. The public changelog and release pages are the right sources for version-specific behavior. Agent Island fits developer-tools and productivity directories because it adds a clear, local status layer to existing AI coding workflows without asking users to move projects into a new environment.
