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
- macOS 15.6+
- Claude Code CLI
Download the latest release or build from source:
xcodebuild -scheme ClaudeIsland -configuration Release buildClaude Island supports two provider integrations that can be enabled independently from the menu:
- Claude Code Hooks
- Installs
claude-island-state.pyin~/.claude/hooks/. - Registers hook commands in
~/.claude/settings.jsonso Claude Code emits lifecycle events.
- Installs
- OpenCode Plugin
- Installs
claude-island-opencode-plugin.tsin either:- Project scope:
<current-project>/.opencode/plugins/ - Global scope:
~/.config/opencode/plugins/
- Project scope:
- In npm plugin mode, updates OpenCode config at
<current-project>/opencode.jsonor~/.config/opencode/opencode.json.
- Installs
The app listens for hook/plugin events over a Unix socket 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.
The OpenCode bridge plugin accepts documented hook names and keeps typed/camelCase aliases for one release. Alias usage is supported with deprecation warnings so integrators can migrate safely.
| Expected hook name | Fallback alias | Required payload fields |
|---|---|---|
session.created |
sessionCreated |
sessionID |
session.updated |
sessionUpdated |
sessionID |
session.idle |
sessionIdle |
sessionID |
session.error |
sessionError |
sessionID |
session.ended |
sessionEnded |
sessionID |
tool.execute.before |
toolExecuteBefore |
sessionID, callID, tool name (tool) |
tool.execute.after |
toolExecuteAfter |
sessionID, callID, tool name (tool) |
permission.ask |
permissionAsk |
sessionID, callID, tool name (tool) |
Claude Island uses Mixpanel to collect anonymous usage data:
- App Launched — App version, build number, macOS version
- Session Started — When a new Claude Code session is detected
No personal data or conversation content is collected.
Apache 2.0