Summary

Ping Island is a macOS menu bar app centralizing AI coding assistant sessions into a Dynamic Island-style interface. It targets developers seeking streamlined monitoring, approvals, and context switching across multiple AI tools, offering a unified, actionable surface directly from the notch.

How It Works

The app acts as a macOS menu bar monitor, expanding into a Dynamic Island-style UI for AI coding agent notifications. It ingests events via hooks, app-servers, and IDE integrations, normalizing them into a unified SessionStore. This enables immediate actions like approvals or context switching directly from the notch, minimizing workflow disruption.

Quick Start & Requirements

• Primary Install: Download the latest DMG from erha19.github.io/ping-island or Releases, move Ping Island.app to Applications, and launch. macOS may prompt for Accessibility/Apple Events permissions.
• Prerequisites: macOS 14.0 or later. Xcode toolchain required for building from source.
• Build from Source: Clone (git clone https://github.com/erha19/ping-island.git), cd ping-island, use xcodebuild. Script ./scripts/package-unsigned.sh available for local testing packages.
• Relevant Links: Official Website: erha19.github.io/ping-island

Highlighted Details

• Consolidates notifications/actions from numerous AI coding assistants (Claude Code, Codex, Gemini CLI, Copilot, etc.) into a single Dynamic Island-style surface.
• Enables direct interaction—approving tools, denying requests, responding to prompts—from the notch.
• Offers one-click return to relevant terminal (iTerm2, Ghostty, Terminal.app, tmux) or IDE windows.
• Supports monitoring/control of AI sessions on remote SSH hosts (macOS/Linux) via PingIslandBridge.
• Features per-event custom sounds and animated agent mascots.

Maintenance & Community

No specific details on maintainers, community channels (Discord/Slack), or a public roadmap are provided. The project appears primarily driven by its repository owner.

Licensing & Compatibility

Licensed under the Apache 2.0 license. This permissive license generally allows for commercial use and integration into closed-source projects without significant restrictions.

Limitations & Caveats

The application is macOS-native and requires macOS 14.0+. Building from source necessitates a specific Xcode toolchain setup (Swift 6.1 Prototype). Core functionality is limited to macOS; remote SSH sessions leverage a bridge. Unsigned builds may require manual user intervention for first launch.