Skip to content
Open
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
51 changes: 29 additions & 22 deletions content/tools/agent-island.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -3,16 +3,15 @@ title: Agent Island
slug: agent-island
category: tools
description: >-
Open-source status companion for Claude Code and Codex with live local
session state, your-turn alerts, usage views, and native macOS and Windows
applications.
Free, MIT-licensed native companion for Claude, Codex, Antigravity, Grok, and
Cursor with local session status, your-turn alerts, and provider usage views.
cardDescription: >-
Monitor local Claude Code and Codex sessions from a native desktop companion
and get notified when an agent needs your attention.
seoTitle: Agent Island - Claude Code and Codex Status Companion
Follow Claude, Codex, Antigravity, Grok, and Cursor from one native companion with
local status, attention alerts, and provider usage views.
seoTitle: Agent Island - AI Coding Session Status Companion
seoDescription: >-
Agent Island is a free, MIT-licensed status companion for Claude Code and
Codex on macOS and Windows with live session state and your-turn alerts.
Agent Island supports Claude, Codex, Antigravity, Grok, and Cursor with local
session status, your-turn alerts, and provider usage views.
author: Tristan Tang
dateAdded: "2026-07-15"
submittedBy: tristan666666
Expand All @@ -28,21 +27,21 @@ operatingSystem: macOS 13+, Windows 10+
sourceUrls:
- "https://github.com/tristan666666/agent-island"
- "https://raw.githubusercontent.com/tristan666666/agent-island/main/README.md"
- "https://github.com/tristan666666/agent-island/releases/tag/v1.6.1"
- "https://github.com/tristan666666/agent-island/releases/tag/v2.1.2"
installable: true
installCommand: "brew install tristan666666/tap/agentisland"
usageSnippet: >-
Install Agent Island, launch the native app, and let it read supported local
Claude Code and Codex session files to show status and attention alerts.
Install Agent Island and launch the native app to see supported local session
status, attention alerts, and provider usage from one companion.
copySnippet: |-
brew install tristan666666/tap/agentisland
estimatedSetupTime: 5 minutes
difficulty: beginner
prerequisites:
- "macOS 13 or later, or Windows 10 or later."
- "A local Claude Code or Codex installation with session data available to the current user."
- "A local install of at least one supported agent - Claude Code, Codex, Antigravity, Grok, or Cursor - with session data available to the current user."
safetyNotes:
- "Agent Island reads local Claude Code and Codex session files to determine session state; review the requested filesystem access before use."
- "Agent Island reads local session files for the supported agents (Claude Code, Codex, Antigravity, Grok, and Cursor) to determine session state; review the requested filesystem access before use."
- "The macOS release is ad-hoc signed rather than Apple-notarized, so first launch requires right-clicking the app and choosing Open."
- "Windows packages are distributed through GitHub Releases, Scoop, and winget; verify the release source before installation."
privacyNotes:
Expand All @@ -52,6 +51,9 @@ privacyNotes:
tags:
- claude-code
- codex
- antigravity
- grok
- cursor
- session-monitoring
- developer-tools
- desktop-app
Expand All @@ -62,22 +64,25 @@ keywords:
- Agent Island
- Claude Code status monitor
- Codex status monitor
- Antigravity status monitor
- Grok coding status monitor
- Cursor usage monitor
- Claude Code notifications
- Codex your turn alerts
- AI coding agent desktop companion
---

## Overview

Agent Island is a native desktop companion for developers who run Claude Code
or Codex in background terminals and need a quick signal when a session is
working, waiting, or needs attention. It presents current session state in a
macOS top bar or Windows top bar and floating widget, then surfaces a system
notification, sound, and alarm window when it is the user's turn.
Agent Island is a native companion for developers who use Claude, Codex,
Antigravity, Grok, and Cursor and want session status, attention signals, and
provider usage in one place. Version 2.1.2 ships macOS and Windows from one tag and presents current supported
session state in the top bar and surfaces a system notification, sound, and
alarm window when it is the user's turn.

The project is MIT licensed and ships separate native implementations for
macOS and Windows. It is a monitoring companion rather than a coding agent: it
does not replace Claude Code or Codex and does not submit prompts on the user's
does not replace the agents it monitors and does not submit prompts on the user's
behalf.

## Install
Expand All @@ -94,14 +99,16 @@ On Windows, install through winget:
winget install TristanTang.AgentIsland
```

The latest GitHub release also provides a macOS DMG and a Windows x64 ZIP.
GitHub Releases provides the current macOS DMG, while the project also
maintains Windows distribution through GitHub Releases, Scoop, and winget.

## Core Capabilities

- Live local session state for Claude Code and Codex.
- Support for Claude, Codex, Antigravity, Grok, and Cursor.
- Live local session state across supported coding-agent sessions.
- Your-turn notifications when a background session needs attention.
- Native macOS and Windows interfaces without an Electron runtime.
- Usage, cost, reset, and weekly report views where provider data is available.
- Provider usage, cost, reset, and weekly report views.
- English and Simplified Chinese interfaces.
- Local-first monitoring with no Agent Island account or product telemetry.

Expand Down