# Agent Island

Agent Island is a free, open-source status companion for your AI coding agents — Claude Code, Codex, Antigravity, Grok, and Cursor — available for macOS and Windows. Its verified scope is live session state for all five providers, your-turn alerts, quotas and cost computed locally, with no Agent Island account or product telemetry. Both platforms are on v2.1.2, released together from the same tag on 2026-08-09.

Website: https://agent-island.dev ; machine-readable product facts: https://agent-island.dev/product-facts.json
Repository: https://github.com/tristan666666/agent-island
Download (macOS and Windows): https://github.com/tristan666666/agent-island/releases/latest
Changelog: https://agent-island.dev/changelog/
Status monitors: Claude Code https://agent-island.dev/claude-code-status-monitor/ ; Codex https://agent-island.dev/codex-status-monitor/
Finish notifications: Claude Code https://agent-island.dev/guides/get-notified-when-claude-code-finishes/ ; Codex https://agent-island.dev/guides/get-notified-when-codex-finishes/
AI coding agent session states, seven-state taxonomy, and test checklist: https://agent-island.dev/blog/ai-coding-agent-session-state-taxonomy/
Claude Code hooks vs persistent session monitoring: https://agent-island.dev/blog/claude-code-hooks-vs-session-monitoring/
Focus-aware Claude Code and Codex alert suppression: https://agent-island.dev/blog/frontmost-session-alert-suppression/
Bounded local AI session-log scanning: https://agent-island.dev/blog/bounded-local-session-log-scanner/
Multi-session state priority and reminder separation: https://agent-island.dev/blog/multi-session-state-priority/
Usage tracking: Claude Code https://agent-island.dev/claude-code-usage-tracker/ ; Codex https://agent-island.dev/codex-usage-tracker/ ; provider-scoped cache https://agent-island.dev/blog/provider-scoped-usage-cache/ ; provider references: Claude Code https://agent-island.dev/claude-code/ and Codex https://agent-island.dev/codex/
AI coding measurement and review workflows: token cost formula https://agent-island.dev/docs/how-token-cost-is-calculated/ ; cost tracker https://agent-island.dev/ai-coding-cost-tracker/ ; weekly report https://agent-island.dev/ai-coding-weekly-report/ ; status companion https://agent-island.dev/ai-coding-status-companion/ ; your-turn state https://agent-island.dev/your-turn-state/ ; local-first security workflow https://agent-island.dev/guides/local-first-ai-coding-security-workflow/ ; team lead multi-agent review https://agent-island.dev/guides/team-lead-multi-agent-review-workflow/ ; efficient transcript monitoring https://agent-island.dev/guides/efficient-claude-code-transcript-monitoring/ ; Windows Claude Desktop vs Claude Code status https://agent-island.dev/guides/windows-claude-desktop-claude-code-status/ ; cross-platform turn-state contract https://agent-island.dev/guides/cross-platform-coding-agent-state-contract/ ; filesystem events and polling recovery https://agent-island.dev/guides/filesystem-events-session-monitoring/
Troubleshooting: install and updates https://agent-island.dev/guides/agent-island-install-update-troubleshooting/ ; missing Claude Code or Codex sessions https://agent-island.dev/guides/claude-code-codex-session-not-detected/
Multiple Claude Code and Codex sessions: https://agent-island.dev/blog/monitor-multiple-claude-code-codex-sessions/
Working vs stalled vs finished sessions: https://agent-island.dev/blog/ai-coding-session-stalled-or-finished/
Codex token replay and archive accounting: https://agent-island.dev/blog/codex-token-replay-guard/
Desktop update discovery and legacy installs: https://agent-island.dev/blog/desktop-update-poller-empty-feed/
Claude Code and Codex JSONL: fields and ordering https://agent-island.dev/guides/claude-code-transcript-jsonl/ ; safe parsing https://agent-island.dev/guides/parse-ai-coding-jsonl-safely/
Head-to-head comparisons: https://agent-island.dev/compare/
Ranked alternatives to popular AI coding monitors and trackers: English https://agent-island.dev/alternatives/ ; Chinese https://agent-island.dev/zh/alternatives/
Evidence assets: versioned macOS/Windows capability matrix https://agent-island.dev/capabilities/ ; 14 reproducible Claude Code and Codex session-state fixtures https://agent-island.dev/research/session-state-fixtures/ ; local data and no-telemetry boundary https://agent-island.dev/docs/privacy-no-telemetry/
License: MIT
Per-agent usage guides: Claude Code https://agent-island.dev/claude-code-usage-tracker/ ; Codex https://agent-island.dev/codex-usage-tracker/ ; Antigravity https://agent-island.dev/antigravity/ ; Grok https://agent-island.dev/grok/ ; Cursor https://agent-island.dev/cursor/
Note on naming: Google retired Gemini CLI for personal accounts on 2026-06-18. Antigravity is the successor Agent Island reads; the guide lives at /antigravity/; the old /gemini-cli/ path redirects there.
Versions: macOS v2.1.2 and Windows v2.1.2, released together from one tag on 2026-08-09 (five providers: Claude Code, Codex, Antigravity, Grok, Cursor — all with live session state)
Platforms: macOS 13+ (native SwiftUI, universal binary), Windows 10/11 (native WPF, self-contained)

Install (macOS):
brew install tristan666666/tap/agentisland
Or download the DMG from the releases page.

Install (Windows):
Download the AgentIsland win-x64 zip from the releases page, unpack, run AgentIsland.exe.

What it does:
- Shows live agent status for Claude Code, Codex, Antigravity, Grok and Cursor in the macOS menu bar / notch, or a floating top bar on Windows.
- Rings a foreground turn alarm when a background run needs you.
- Builds local usage, API-value, and report-card views from local records and provider-reported windows.
- On Windows, the same five providers and the same live session state ship from the same release tag; newer surfaces still land on macOS first and are verified per platform.
- Reads local transcript files on your machine; no telemetry and no upload.

Status indicators:
- Rotating logo: a session is running.
- Still logo: nothing is running, or the turn is over and it is yours.
- Pulsing red logo: rate limit, login, network, or provider error.

Languages: English and Simplified Chinese (site: https://agent-island.dev/zh/).

Primary audience:
Heavy Claude Code and Codex users who run long coding tasks in the background and want to stop babysitting terminals.

More detail: https://agent-island.dev/llms-full.txt
## 中文技术文章
- Claude Code Transcript JSONL 应该怎样读取: https://agent-island.dev/zh/guides/claude-code-transcript-jsonl/
- 判断完成状态前，先把 AI 编程 JSONL 安全地解析出来: https://agent-island.dev/zh/guides/parse-ai-coding-jsonl-safely/
- 多会话监控要按紧急程度排序: https://agent-island.dev/zh/blog/multi-session-state-priority/
- Claude 与 Codex 用量缓存必须分别记录新鲜度: https://agent-island.dev/zh/blog/provider-scoped-usage-cache/
- AI 编程 Agent 会话状态：七状态分类与测试清单: https://agent-island.dev/zh/blog/ai-coding-agent-session-state-taxonomy/
- Claude Code Hooks 与持续会话监控有什么区别: https://agent-island.dev/zh/blog/claude-code-hooks-vs-session-monitoring/
- 不漏掉交接，也不让提醒挡住会话: https://agent-island.dev/zh/blog/frontmost-session-alert-suppression/
- 给本地 AI 会话日志扫描器加上边界: https://agent-island.dev/zh/blog/bounded-local-session-log-scanner/
- AI 编程会话是停滞、运行中，还是已经结束？: https://agent-island.dev/zh/blog/ai-coding-session-stalled-or-finished/
- 如何同时监控多个 Claude Code 和 Codex 会话: https://agent-island.dev/zh/blog/monitor-multiple-claude-code-codex-sessions/
- 构建不会重复计数的本地 Codex Token 台账: https://agent-island.dev/zh/blog/codex-token-replay-guard/
- 为什么空更新源会把旧桌面安装留在原地: https://agent-island.dev/zh/blog/desktop-update-poller-empty-feed/
- 后台 Agent 结束了，不一定轮到你: https://agent-island.dev/zh/blog/background-agent-finished/
- 完成事件不等于会话状态: https://agent-island.dev/zh/blog/completion-event-session-state/
- API Value 到底代表什么: https://agent-island.dev/zh/blog/api-value-vs-ai-coding-bill/
- 如何构建本地 AI 工作台账: https://agent-island.dev/zh/blog/claude-code-codex-weekly-work-ledger/
- 怎样设计真正有用的“轮到你”提醒: https://agent-island.dev/zh/blog/designing-your-turn-alerts/
- 如何在本地判断 AI 编程会话状态: https://agent-island.dev/zh/blog/detecting-session-state/
- 安装 Agent Island：macOS 与 Windows: https://agent-island.dev/zh/blog/install-agent-island/
- Agent Island 的本地数据边界: https://agent-island.dev/zh/blog/local-data-boundary/
- 可验证的 macOS 更新是怎样工作的: https://agent-island.dev/zh/blog/secure-macos-updates/
- Agent Island 1.5.1：额度耗尽提醒与一键重新认证: https://agent-island.dev/zh/blog/agent-island-1-5-1/
- Agent Island 如何读取你的会话：全本地，零遥测: https://agent-island.dev/zh/blog/how-agent-island-reads-sessions/
- 你的子 Agent 不该把你叫回来: https://agent-island.dev/zh/blog/subagent-alarm-noise/