UniIsland

Real-time AI coding agent status panel for macOS Dynamic Island (Notch)
Install • Features • Supported Tools • Build
English | 简体中文

---

What is UniIsland?

UniIsland lives in your MacBook's notch area and shows you what your AI coding agents are doing — in real time. No more switching windows to check if Claude is waiting for approval or if Codex finished its task.

It connects to 12 AI coding tools via Unix socket IPC, displaying session status, tool calls, permission requests, and more — all in a compact, pixel-art styled panel.

Features

• Notch-native UI — Expands from the MacBook notch, collapses when idle
• 12 AI tools supported — Claude Code, Codex, Gemini CLI, Cursor, Copilot, Trae/Traecli, Qoder, Factory, CodeBuddy, OpenCode, Kimi Code CLI, Cline
• Live status tracking — See active sessions, tool calls, and AI responses in real time
• Permission management — Approve/deny tool permissions directly from the panel
• Question answering — Respond to agent questions without leaving your current app
• Pixel-art mascots — Each AI tool has its own animated character
• One-click jump — Click a session to jump to its terminal tab or IDE window
• Smart suppress — Tab-level terminal detection: only suppresses notifications when you're looking at the specific session tab, not just the terminal app
• Sound effects — Optional 8-bit sound notifications for session events
• Auto hook install — Automatically configures hooks for all detected CLI tools, with auto-repair and version tracking
• Bilingual UI — English and Chinese, auto-detects system language
• Multi-display — Works with external monitors, auto-detects notch displays

Supported Tools

	Tool	Events	Jump	Status
	Claude Code	13	Terminal tab	Full
	Codex	3	Terminal	Basic
	Gemini CLI	6	Terminal	Full
	Cursor	10	IDE	Full
	TraeCli	10	Terminal	Full
	Qoder	10	IDE	Full
	Copilot	6	Terminal	Full
	Factory	10	IDE	Full
	CodeBuddy	10	APP/Terminal	Full
	Kimi Code CLI	10	Terminal	Full
	OpenCode	All	APP/Terminal	Full
	Cline	5	VSCode	Full

Installation

Homebrew (Recommended)

brew tap wxtsky/tap
brew install --cask uniisland

Manual Download

1. Go to Releases
2. Download UniIsland.dmg
3. Open the DMG and drag UniIsland.app to your Applications folder
4. Launch UniIsland — it will automatically install hooks for all detected AI tools

Note: On first launch, macOS may show a security warning. Go to System Settings → Privacy & Security and click Open Anyway.

Build from Source

Requires macOS 14+ and Swift 5.9+.

git clone https://github.com/wxtsky/UniIsland.git
cd UniIsland

# Development (debug build + launch; Buddy Bluetooth needs the .app below)
swift build && ./.build/debug/UniIsland

# Release (universal binary: Apple Silicon + Intel)
./build.sh
open .build/release/UniIsland.app

How It Works

AI Tool (Claude/Codex/Gemini/Cursor/...)
  → Hook event triggered
    → uniisland-bridge (native Swift binary, ~86KB)
      → Unix socket → /tmp/uniisland-<uid>.sock
        → UniIsland app receives event
          → Updates UI in real time

UniIsland installs lightweight hooks into each AI tool's config. When the tool triggers an event (session start, tool call, permission request, etc.), the hook sends a JSON message through a Unix socket. UniIsland listens on this socket and updates the notch panel instantly.

For OpenCode, a JS plugin connects directly to the socket — no bridge binary needed.

Settings

UniIsland provides a 7-tab settings panel:

• General — Language, launch at login, display selection
• Behavior — Auto-hide, smart suppress, session cleanup
• Appearance — Panel height, font size, AI reply lines
• Mascots — Preview all pixel-art characters and their animations
• Sound — 8-bit sound effects for session events
• Hooks — View CLI installation status, reinstall or uninstall hooks
• About — Version info and links

Requirements

• macOS 14.0 (Sonoma) or later
• Works best on MacBooks with a notch, but also works on external displays

Acknowledgments

This project was inspired by claude-island by @farouqaldori. Thanks for the original idea of bringing AI agent status into the macOS notch.

Open-Source Citations & References

UniIsland incorporates and builds upon capabilities inspired by the following excellent open-source utilities:

• NotchDrop (GitHub) — Inspiration for the dynamic file drop zone and temporary files panel logic.
• Boring Notch (GitHub) — References for media playback controllers, diagnostic monitors, and Pomodoro focus workflows.
• Atoll (GitHub) & DynamicNotch (GitHub) — Inspiration for modular settings and diagnostic activity HUD design layouts.
• SuperIsland (GitHub) — Core references for system battery level animations, EventKit calendar lookup count-downs, and automated virtual meeting joining.

Star History

License

MIT License — see LICENSE for details.