← all repositories
erha19/ping-island

Taming a dozen AI agents from a single macOS notch

It pulls approvals, prompts, and session status from a dozen AI coding tools into one macOS menu bar surface.

1.1k stars Swift Coding AssistantsAgents
ping-island
Velocity · 7d
+23
★ / day
Trend
accelerating
star history

What it does Ping Island is a native macOS menu bar utility that watches AI coding agents—Claude Code, Codex, Gemini CLI, Cursor, GitHub Copilot, and others—for moments when they need approval, input, or review. Instead of hunting through terminal tabs or IDE windows, you see the request in a compact surface that expands from the notch, act on it, and jump straight back to the correct session. It also supports remote SSH sessions via a PingIslandBridge binary and can auto-approve Claude Code tool requests per session.

The interesting bit The app treats each supported tool as a distinct integration with its own hook format and even its own animated mascot—Claude, a capybara for Qwen, a courier fox for Hermes—so sessions remain visually distinct in the notch. That level of polish for a developer utility is unusual; most notification aggregators would have settled for identical gray rectangles.

Key highlights

  • Supports 12-plus agent families, including Claude Code, Codex, Gemini CLI, Cursor, Qwen Code, Kimi CLI, and GitHub Copilot, each with distinct hook handling.
  • Expands from the macOS notch (or sits in the menu bar) only when a session needs attention, keeping the UI compact otherwise.
  • Can detach the active “Buddy” mascot as a floating companion window so status stays visible while you work elsewhere.
  • One-click focus return to the originating terminal or IDE window, including tmux panes and remote SSH sessions bridged over a local binary.
  • Per-session auto-approval for Claude Code and custom sound packs for notifications.

Caveats

  • Requires macOS 14+ and Accessibility permissions for window-focus features.
  • The Linux bridge asset is available, but SSH support involves bootstrapping a remote binary and rewriting remote hooks, which is not zero-configuration.
  • Some integrations are hook-only or notify-only, meaning Ping Island cannot always submit answers back into the client.

Verdict Developers who run multiple AI coding agents in parallel and are tired of context-switching between terminal tabs will find this genuinely useful. If you only ever use a single agent inside one IDE, it is probably overkill.

Frequently asked

What is erha19/ping-island?
It pulls approvals, prompts, and session status from a dozen AI coding tools into one macOS menu bar surface.
Is ping-island open source?
Yes — erha19/ping-island is open source, released under the Apache-2.0 license.
What language is ping-island written in?
erha19/ping-island is primarily written in Swift.
How popular is ping-island?
erha19/ping-island has 1.1k stars on GitHub and is currently accelerating.
Where can I find ping-island?
erha19/ping-island is on GitHub at https://github.com/erha19/ping-island.

heatdrop uses Google Analytics to see which pages get read — nothing else. Your call. How we handle data.