Agent Island

A status companion for Claude Code and Codex.

See what every run is doing. Step away, and Agent Island calls you back when it is your turn. Local-first, no Agent Island account, no product telemetry.

agent-island.dev · 简体中文

_{▶ HD version}

Quick Start · Download · Website · How it works · Contribute

Choose your platform and install the current v1.7.1 release directly:

On macOS, drag Agent Island into Applications. The app is ad-hoc signed rather than notarized, so the first launch requires right-clicking the app in Finder and choosing Open.

On Windows, unzip the archive and run AgentIsland.exe.

brew install tristan666666/tap/agentisland

winget install TristanTang.AgentIsland

scoop bucket add agent-island https://github.com/tristan666666/scoop-bucket
scoop install agent-island/agentisland

git clone https://github.com/tristan666666/agent-island.git
cd agent-island
./scripts/verify.sh
open build/AgentIsland.app

• Features
  • Status monitoring
  • Usage
  • Weekly & monthly report cards
  • It's-your-turn clock
  • Personalization
  • macOS and Windows
• Community
• How it works
• Why Agent Island
• Privacy and safety
• FAQ
• Contributing
• Roadmap and releases
• Credits and license

Agent Island mirrors local Claude Code, Claude Desktop, and Codex session activity in a compact top bar. You can scan the state without bringing each session to the foreground — the two states below sit one hover apart:

Swipe through local usage and cost views for Claude and Codex. Provider usage data comes from provider-owned usage endpoints through the local credential store; cost and model summaries are calculated locally from session records.

Machines with a single subscription get the solo layout automatically — the provider's mark and name hold one half of the panel, the live windows the other:

Shareable cards rendered locally: total tokens with an ≈ API value line, a Claude-vs-Codex faction duel whose clash sits exactly at your usage split (the leading side wins the crown), 7-day bars with a TOP-3 model donut (weekly) or a TOP-5 donut (monthly), and your island rank as the closing line. Copying or sharing a card is an explicit user action; Agent Island does not publish it for you.

English · Claude wins the week

简体中文 · Codex wins the month

When a background turn finishes, Agent Island can show an alarm window, send a system notification, and play a sound. Multiple completed turns queue instead of replacing one another, and responding clears the corresponding reminder. If you are already looking at the session's terminal or editor, the alarm holds — it fires the moment you switch away with the turn still open.

The island is yours to tune. Usage tiles come in five chart styles with a used-or-remaining quota toggle and cycling cost styles. The ambient light runs Vivid — halo and orbit sweep in your pick of teal, cobalt, violet, or silver — or fully-dark Calm, which saves color for real warnings. Screens without a notch get a 100–150% interface scale.

Agent Island is a native desktop app on both supported platforms, with English and Simplified Chinese interfaces.

• macOS 13+: SwiftUI universal app for Apple silicon and Intel, with wide and compact top-bar layouts.
• Windows 10/11 x64: native WPF app with a top bar, draggable floating widget, and tray presence.

Chinese-speaking users — scan the group QR to join directly. Group codes rotate every 7 days; if it has expired, add the author and mention "Agent Island" to be invited:

WeChat group — scan to join

Group code expired? Add the author, mention "Agent Island"

See Agent Island on Product Hunt.

flowchart LR
    A[Claude and Codex local files] --> B[Local parser and state machine]
    B --> C[Top bar and alerts]
    B --> D[Local cost and report views]
    E[Provider-owned usage endpoints] --> D

• Session state comes from transcript and activity files that Claude Code, Claude Desktop, and Codex already write to disk. Local file events and turn markers drive the working and needs-you states.
• Usage and reset data comes from provider-owned usage endpoints through the local credential store.
• Cost, model, and report summaries are calculated locally from local session records.

Read the implementation overview: How Agent Island detects Claude Code and Codex session state.

Long Claude Code and Codex runs should not require keeping every terminal in view. Agent Island gives each provider a persistent status surface, tells you when a run needs attention, and brings you back when the next action is yours.

It is built for developers who:

• run Claude Code and Codex sessions in parallel;
• leave long tasks working in the background;
• want status, alerts, usage views, and shareable report cards without sending session data to another service;
• care what their desk looks like — the island's light, layout, and cards are tuned like a product, not a debug overlay.

How it compares with its neighbors:

_{Based on each product's public materials as of July 2026 — corrections welcome via issue.}

• No Agent Island account is required.
• Session data is not uploaded to Agent Island.
• The app has no product telemetry.
• Usage and authentication calls go directly to provider-owned endpoints through the local credential store.
• If you use Claude re-authentication, Agent Island may refresh and update credentials shared with Claude Code or Claude Desktop in that local store.
• macOS updates are verified by Sparkle with an EdDSA signature before installation.

Agent Island reads the local files and credentials required to provide these views. Review the source and release artifacts before installing, as you would for any local developer tool.

Contributions are welcome across macOS, Windows, documentation, tests, and localization. Start with CONTRIBUTING.md and the Code of Conduct.

Current good first issues:

• #10: Document the Windows contributor build and test workflow
• #11: Add a localization key parity check
• #15: Add a public-copy guard for retired feature claims

Run ./scripts/verify.sh before opening a macOS pull request. Windows changes are checked by the repository's Windows CI workflow.

• Latest release
• Roadmap
• Open issues

Agent Island is a fork of codex-island by Eric Park. The original usage-island and cost-tracking foundation are his work. Agent Island adds live session-state views, your-turn alerts, cross-platform support, and its own product direction.

MIT licensed. Copyright 2026 Eric Park. This fork retains the original notice. See LICENSE.