🐕 Agent Island

• 🎨 Idle Icon System — 6 pixel-art icons (Dog, Cat, Robot, Island, Ghost, Lighthouse) with status animations
• 🔴 Dynamic Notch UI — Expands from the MacBook notch to show session status and controls
• 🤖 Multi-Provider Support — Monitor Claude Code, Codex CLI, Kimi CLI, Cursor, Gemini CLI, and Qwen simultaneously
• 📊 Status Indicators — Visual state symbols: ! (processing), ? (waiting approval), ✓ (done)
• 🔔 Smart Notifications — Sound alerts for session start, tool approvals, and task completion
• ✅ Permission Handling —
  • Claude / Qwen: Approve/deny directly in the notch
  • Codex / Kimi / Gemini: "Go to Terminal" button for quick access
  • Cursor: return to the IDE to approve
• 💬 Chat History — View full conversation history with markdown rendering
• 🏷️ Status Bar Phrases — Scrolling status text in the closed notch with theme packs (Default / Doggy / Custom)
• ✨ Marquee Text Effects — Five animation styles for status phrases: scroll, flash, typewriter, sparkle, and static, with adjustable speed
• 🖥️ Browser Fullscreen Auto-Hide — Notch bar automatically hides when Safari, Chrome, Firefox, Edge, Arc, or Brave enters fullscreen
• ⚙️ Preferences Window — Settings for idle icon, sounds, marquee phrases, and CLI hooks
• 🔧 Auto-Setup — Hooks install automatically for enabled CLIs

• macOS 15.6+
• At least one supported AI CLI installed

Download the latest DMG from Releases and drag to Applications.

For local development or testing without an Apple Developer account:

# Clone the repository
git clone https://github.com/Ruczhutao/claude-island.git
cd claude-island

# Build with local signing
./scripts/build-local.sh

# The DMG will be created at:
# releases/AgentIsland-x.x.x-local.dmg

First Launch: Right-click the app → Open → Open (to bypass Gatekeeper for unsigned local builds).

# Open in Xcode
open ClaudeIsland.xcodeproj

# Or build via command line
xcodebuild -scheme ClaudeIsland -configuration Release build

Agent Island installs hooks into each CLI's config directory:

• ~/.claude/hooks/ for Claude Code
• ~/.codex/hooks/ for Codex CLI
• ~/.kimi/hooks/ for Kimi CLI
• ~/.cursor/hooks.json for Cursor (3.0+)
• ~/.gemini/settings.json for Gemini CLI
• ~/.qwen/settings.json for Qwen

Hooks communicate session state via a Unix socket (/tmp/claude-island.sock). The app listens for events and displays them in the notch overlay.

Three 8-bit retro sound effects included:

• Session Start — New CLI session detected
• Need Approval — Tool execution waiting for permission
• Task Complete — AI finished responding

Plus 13 macOS system sounds available. Custom MP3s are hot-reloaded from the app's Sounds directory—no restart required.

Agent Island uses Mixpanel to collect anonymous usage data:

• App Launched — App version, build number, macOS version
• Session Started — When a new CLI session is detected

No personal data or conversation content is collected.

Apache 2.0

Made with ❤️ by developers, for developers.