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

Choose your platform and install the current v1.6.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.

Homebrew, WinGet, and Scoop may lag behind the latest GitHub release. Check the version they offer before installing.

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

Build the macOS app from source:

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

Windows build and test instructions are tracked in issue #10.

Table of Contents

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

Features

Status monitoring

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.

It's-your-turn clock

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.

Usage & reports

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.

Agent Island also renders weekly and longer-range report cards on your machine. Copying or sharing a card is an explicit user action; Agent Island does not publish it for you.

macOS and Windows

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.

How it works

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.

Community

Chinese-speaking users can join the WeChat community:

See Agent Island on Product Hunt.

Why Agent Island

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, and usage views without sending session data to another service.

How it compares with its neighbors:

| | Agent Island | Vibe Island | CodexBar | [ccusage](https: