Install Agent Island

Agent Island v1.6.1 is the current public stable release. The release includes a macOS DMG and a Windows x64 ZIP. Both are distributed from the project's public GitHub Releases page.

macOS

The shortest installation path is Homebrew:

brew install tristan666666/tap/agentisland

You can also download the latest DMG, drag AgentIsland into Applications, and open it. The current app is ad-hoc signed rather than Apple-notarized, so macOS may require one right-click and Open on first launch.

Windows

Download AgentIsland-1.6.1-win-x64.zip from the latest release, unzip it, and run AgentIsland.exe. Scoop is also available:

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

Verify the status signal

Start a Claude Code or Codex session and send a real task. The matching provider mark should enter its working state. When the turn finishes and needs a reply, Agent Island can surface the handoff.

Agent Island your-turn alert shown after a coding-agent session finishes — Demonstration capture of the your-turn alert. The app does not send the underlying transcript to Agent Island.

Build from source

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

Use the source path when you want to audit the local readers or build the macOS app yourself.

Package names and versions in this guide were checked against the live v1.6.1 release.

← All posts