This is the five-minute setup. By the end the island is in your menu bar or tray, notifications are allowed, and your first coding session is showing up in it.
Before you start
- A Mac on macOS 13 or later, or a PC on Windows 10/11
- At least one AI coding tool installed and run once
1. Install it
macOS — Homebrew:
brew install tristan666666/tap/agentislandWindows — WinGet:
winget install TristanTang.AgentIslandOr take the DMG or the x64 ZIP straight from the latest release.
2. Clear the first-launch prompt
The app is signed ad hoc rather than with a paid Developer ID, so macOS may refuse the first open. Homebrew clears the flag for you; a manual DMG install may not:
xattr -dr com.apple.quarantine /Applications/AgentIsland.appOn Windows, right-click the downloaded ZIP → Properties → tick Unblock before extracting.
3. Allow notifications once
Accept the permission prompt on first run. Agent Island asks for alert permission and nothing else — no accessibility, no screen recording.
4. Let it find your agents
No configuration. It reads the session records your coding tools already write locally, and picks up any provider you are signed in to.
5. Turn on Launch at Login
Open Settings → General and switch on Launch at Login so the island is there every morning without you thinking about it.
If it does not work
That is the quarantine flag, not a broken download. Apply step 2 — the -r matters, because the nested updater bundle needs it too.
No detected sign-in means no row. Sign in to at least one coding tool, then give it one refresh cycle.
The app was replaced while running. Launch it once from the Start menu.