Summary

CodeIsland offers a real-time status panel for AI coding agents, integrating directly into the macOS Dynamic Island (notch). It enables developers to monitor agent activity, manage permissions, and respond to queries without context switching, enhancing workflow efficiency.

How It Works

Lightweight hooks in AI tools trigger events, relayed via Unix sockets to the CodeIsland app by a native Swift binary (codeisland-bridge). This allows instant UI updates in the notch panel, displaying live agent status and facilitating direct interaction. For OpenCode, a JS plugin connects directly to the socket.

Quick Start & Requirements

Install via Homebrew (brew tap wxtsky/tap && brew install --cask codeisland) or download CodeIsland.dmg. Requires macOS 14.0 (Sonoma) or later; Swift 5.9+ for source builds. The app automatically installs and manages hooks for detected CLI tools.

Highlighted Details

• Notch-native UI that expands/collapses.
• Supports 9 AI tools (Claude, Codex, Gemini, Copilot, etc.) with full/basic event tracking and jump capabilities.
• Real-time session status, tool calls, and AI responses.
• In-panel permission management and question answering.
• Pixel-art mascots and optional 8-bit sound notifications.
• One-click jump to terminal/IDE.
• "Smart suppress" feature based on active tab.
• Bilingual UI and multi-display support.

Maintenance & Community

Inspired by claude-island by @farouqaldori. No specific details on active maintainers, community channels, or sponsorship were provided.

Licensing & Compatibility

Released under the MIT License, generally permissive for commercial use and integration into closed-source projects.

Limitations & Caveats

Requires macOS 14.0 (Sonoma) or later. Optimized for MacBooks with a notch, though functional on external displays.