# Agent Island > An open-source, local-first desktop status companion for Claude Code and Codex that shows live session state and your-turn alerts in the macOS and Windows menu bar. Agent Island is a free, MIT-licensed desktop app that lives in the macOS menu bar or Windows top bar and monitors Claude Code, Claude Desktop, and OpenAI Codex sessions in real time. It is built by tristan666666 (a fork of Eric Park's codex-island) and runs entirely on the local machine — no Agent Island account, no product telemetry, and no session data uploaded anywhere. The current release is v1.7.1, published July 16, 2026. ## What It Is Agent Island is a native status companion for developers who run long AI coding-agent sessions in the background. It reads the transcript and activity files that Claude Code, Claude Desktop, and Codex already write to disk, then surfaces a compact live view in the system top bar. When a background run finishes and needs a response, Agent Island fires an alarm window, a system notification, and a sound — so developers can step away without watching every terminal. ## How It Works The app uses a local parser and state machine fed by local file events and turn markers: - **Session state** is derived from transcript and activity files already written to disk by Claude Code, Claude Desktop, and Codex — no additional instrumentation required. - **Usage and reset data** comes from provider-owned usage endpoints, called through the local credential store. - **Cost, model, and report summaries** are calculated locally from session records and never leave the machine. The menu-bar icon communicates state at a glance: a rotating logo means a session is working, a still logo means idle, and a pulsing red logo means a session needs attention due to a provider, login, network, or rate-limit error. ## Key Features - **Live session monitoring** for Claude Code, Claude Desktop, and Codex in a compact top bar - **Your-turn alarm** with an alarm window, system notification, sound, and a queue for multiple completed turns - **Usage and cost views** with five chart styles, a used-or-remaining quota toggle, and cycling cost styles - **Weekly and monthly report cards** rendered locally — total tokens with an approximate API value line, a Claude-vs-Codex faction duel, 7-day bars, a TOP-3/TOP-5 model donut, and an island rank - **Personalization** via Vivid (halo and orbit sweep in teal, cobalt, violet, or silver) or Calm (fully dark) ambient modes - **English and Simplified Chinese** interfaces on both platforms ## Platform and Deployment Model Agent Island ships as a native desktop app on two platforms: - **macOS 13+**: SwiftUI universal binary for Apple silicon and Intel, installable via `brew install tristan666666/tap/agentisland`, DMG download, or source build - **Windows 10/11 x64**: native WPF app with a top bar, draggable floating widget, and tray presence, installable via WinGet, Scoop, or zip download The app is ad-hoc signed rather than notarized on macOS (no paid Apple Developer account), so the first launch requires right-clicking and choosing Open. macOS updates are independently verified by Sparkle with an EdDSA signature before installation. ## Update: v1.7.1 The latest release, v1.7.1 (published July 16, 2026), is the current stable version listed in the GitHub releases page. The repository was created June 17, 2026 and last pushed July 17, 2026, indicating active early development. The project is listed in several community curated lists including awesome-mac, awesome-swift-macOS, awesome-codex-cli, awesome-coding-agents, awesome-claude-code-and-skills, awesome-vibe-coding-resources, and awesome-vibecoding, and has been featured on Product Hunt and Launch Llama. ## Open-Source Lineage Agent Island is a fork of codex-island by Eric Park, which established the usage-island and cost-tracking foundation. The fork adds live session-state detection, your-turn alerts, Windows support, weekly and monthly report cards, and a broader desktop workflow. The full source is public on GitHub under the MIT license, with contributions welcomed across macOS, Windows, documentation, tests, and localization. ## Features - Live session state monitoring for Claude Code, Claude Desktop, and Codex - Your-turn alarm window with sound and notification queue - Menu-bar icon with rotating/pulsing state cues - Usage and cost views with five chart styles - Weekly and monthly shareable report cards rendered locally - Claude-vs-Codex faction duel with island rank - Out-of-quota alarm - Local-first: no account, no telemetry, no data uploads - English and Simplified Chinese interfaces - macOS 13+ SwiftUI universal app (Apple silicon and Intel) - Windows 10/11 x64 native WPF app with floating widget - Homebrew, WinGet, and Scoop package manager support - Vivid and Calm ambient light modes with color personalization - Sparkle EdDSA signature verification for macOS updates ## Integrations Claude Code, Claude Desktop, OpenAI Codex, Homebrew, WinGet, Scoop, Sparkle (macOS update framework) ## Platforms WINDOWS, MACOS, LINUX, WEB, API, CLI ## Pricing Open Source ## Version v1.7.1 ## Links - Website: https://agent-island.dev/ - Documentation: https://github.com/tristan666666/agent-island/blob/main/README.md - Repository: https://github.com/tristan666666/agent-island - EveryDev.ai: https://www.everydev.ai/tools/agent-island