A macOS menu bar app that brings Dynamic Island-style notifications to Claude Code CLI sessions.
- Notch UI — Animated overlay that expands from the MacBook notch
- Live Session Monitoring — Track multiple Claude Code 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
This is a fork of the original claude-island by farouqaldori.
Key improvements in this fork:
- Code quality — Strict linting with SwiftFormat, SwiftLint (70+ rules), pre-commit hooks, and modern Swift concurrency (
@Observable,Sendable, structured concurrency) - Bug fixes — Various stability and reliability improvements
- Merged upstream PRs — See merged pull requests for integration details
- macOS 15.6+
- Claude Code CLI
Download the latest .dmg from GitHub Releases, open it, and drag Claude Island into Applications. IMG
Claude Island is ad-hoc signed and not notarized, so macOS blocks the first launch.
- Open the app — macOS shows "Claude Island" Not Opened. Click Done.
IMG - Go to System Settings → Privacy & Security, find the blocked notice, and click Open Anyway.
IMG - In the confirmation dialog, click Open Anyway.
IMG - Authenticate with Touch ID or your password.
IMG
macOS prompts for access to "Claude Code-credentials" (the CLI's OAuth token, used for optional usage-quota tracking). Click Always Allow. IMG
- The app shows an Accessibility Permission Required dialog. Click Open Settings.
IMG - In System Settings → Privacy & Security → Accessibility, click the + button.
IMG - Navigate to Applications, select Claude Island, and click Open.
IMG - Claude Island now appears in the Accessibility list with the toggle enabled.
IMG
Tip: If Claude Island is already listed but not working, remove it first (click −), then re-add it with the steps above.
Subsequent launches require no extra setup. Auto-updates via Sparkle work normally.
Permissions Questions? Learn more about why Claude Island needs accessibility and keychain permissions.
If you prefer, you can skip the Gatekeeper steps above by removing the quarantine attribute:
xattr -d com.apple.quarantine "/Applications/Claude Island.app"xcodebuild -scheme ClaudeIsland -configuration Release build
Claude Island installs hooks into ~/.claude/hooks/ that communicate session state via a Unix socket. The app listens for events and displays them in the notch overlay.
When Claude needs permission to run a tool, the notch expands with approve/deny buttons—no need to switch to the terminal.
Apache 2.0