A macOS menu bar app that brings Dynamic Island-style notifications to Claude Code, Gemini CLI, Qwen Code, and Codex sessions.
- Notch UI — Animated overlay that expands from the MacBook notch
- Multi-Agent Support — Support for Claude Code, Gemini CLI, Qwen Code, and Codex
- Live Session Monitoring — Track multiple agent sessions in real-time
- Permission Approvals — Approve or deny tool executions directly from the notch
- Chat History — View full conversation history with markdown rendering
- Auto-Setup — Hooks install automatically on first launch
- macOS 15.6+
- Claude Code, Gemini CLI, Qwen Code, or Codex
Download the latest release or build from source:
xcodebuild -scheme ClaudeIsland -configuration Release buildAgent Island installs hooks into agent configuration directories (e.g., ~/.claude/hooks/) that communicate session state via a Unix socket. The app listens for events and displays them in the notch overlay.
When an agent needs permission to run a tool, the notch expands with approve/deny buttons—no need to switch to the terminal.
Codex integration uses ~/.codex/config.toml and installs ~/.codex/hooks/codex-island-state.py. Agent Island only registers Codex-supported hook events:
UserPromptSubmitPreToolUsePostToolUsePermissionRequestStopSessionStart
The installer also writes Codex hook review state with enabled = true under [hooks.state], which matches current Codex hook approval behavior and avoids repeated "hooks need review" prompts. Unsupported Claude-style events such as Notification, SessionEnd, and PreCompact are not registered for Codex.
Agent Island uses Mixpanel to collect anonymous usage data:
- App Launched — App version, build number, macOS version
- Session Started — When a new agent session is detected
No personal data or conversation content is collected.
Hook events are sent over a same-user Unix socket. Non-approval events use a short socket timeout and Codex tool lifecycle updates avoid sending full tool input payloads unless an approval decision is required.
Apache 2.0