Summary

Open Island is an open-source, local-first macOS companion application designed for heavy AI coding agent users. It provides a native control surface, integrated into the Mac's notch or top bar, offering real-time session status, permission approvals, and instant jump-back to the correct terminal or IDE. This addresses the need for a transparent, user-owned alternative to closed-source monitoring tools, enhancing developer workflow without compromising privacy or control.

How It Works

The system operates via agent hooks that emit events. These events are captured by a lightweight CLI (OpenIslandHooks) and forwarded via a Unix socket to an in-app BridgeServer. The BridgeServer updates the native SwiftUI/AppKit UI, including the notch overlay and control center. Users can then click to jump back to the precise terminal or IDE session where the agent activity occurred. This architecture ensures a local-first, no-telemetry approach, with hooks designed to "fail open," meaning agents continue to function if Open Island is not running.

Quick Start & Requirements

Installation is straightforward: download the latest signed and notarized DMG from GitHub Releases, or build from source by cloning the repository and opening Package.swift in Xcode. Alternatively, use zsh scripts/package-app.sh to create a distributable .app bundle.

• Requirements: macOS 14+, Swift 6.2, Xcode.
• Documentation: Detailed architecture and setup guides are available in the docs/ directory.

Highlighted Details

• Multi-Agent Support: Integrates with numerous AI coding agents including Claude Code, Codex, Cursor, OpenCode, Qoder, Qwen Code, Factory, and CodeBuddy.
• Extensive Terminal/IDE Compatibility: Offers full jump-back support for Terminal.app, Ghostty, iTerm2, tmux, Zellij, and others, alongside workspace activation for VS Code, JetBrains IDEs, and more.
• Native macOS Experience: Built with SwiftUI and AppKit, featuring a notch overlay, control center, and system notifications.
• Local-First & Open Source: Operates entirely on the user's Mac with no server dependency or telemetry, licensed under GPL v3.

Maintenance & Community

The project actively welcomes community contributions, including issues and pull requests. Users can join the Discord server for discussion and faster issue resolution, or use the WeChat group for Chinese-speaking users.

Licensing & Compatibility

Open Island is licensed under the GPL v3 license. This is a strong copyleft license, requiring derivative works to be distributed under the same terms. Compatibility for commercial use or integration into closed-source projects should be carefully evaluated due to these restrictions.

Limitations & Caveats

The project is macOS-exclusive. Features like Gemini CLI integration and Warp terminal support are listed as "Planned." Specific Swift and Xcode versions are required for building from source.