Claude Island

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 release from GitHub Releases or build from source:

xcodebuild -scheme ClaudeIsland -configuration Release build

Since Claude Island uses ad-hoc signing (not notarized), macOS will block the first launch.

1. Download and open the DMG from GitHub Releases
2. Drag Claude Island to Applications
3. Try to open the app — it will be blocked
4. Go to System Settings → Privacy & Security
5. Find "Claude Island was blocked" and click Open Anyway
6. Click Open in the confirmation dialog

xattr -d com.apple.quarantine "/Applications/Claude Island.app"

This is only required on first launch. Auto-updates via Sparkle work normally.

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