CodeIsland provides a real-time AI coding agent status panel for macOS notch displays, with 13 tool integrations, Live Activity sharing to iPhone/Apple Watch, and a 7-tab settings panel. It installs hooks for tools and communicates via a Unix socket IPC model.
Collecting history — the radar snapshots this repo daily. The trend line appears after 3 days of data (1 so far).
What it is
CodeIsland is a real-time AI coding agent status panel that lives in the MacBook notch area, displaying status for multiple AI tools and enabling permission approvals from the panel. It connects to 13 AI coding tools via Unix socket IPC and can mirror session status to iPhone and Apple Watch companions.
How it works
CodeIsland installs lightweight hooks into each AI tool's config. When a tool triggers events (session start, tool call, permission request, etc.), a hook sends a JSON message through a Unix socket to a native Swift bridge, which communicates with the CodeIsland app to update the UI in real time and optionally sync to the iPhone/Watch companion. For OpenCode, a JS plugin connects directly to the socket.
Getting started
Installation options:
- Homebrew (Recommended)
brew tap wxtsky/tap
brew install --cask codeisland
- Manual Download
- Go to Releases
- Download
CodeIsland.dmg - Open the DMG and drag
CodeIsland.appto your Applications folder - Launch CodeIsland — it will automatically install hooks for all detected AI tools
Build from source:
git clone https://github.com/wxtsky/CodeIsland.git cd CodeIsland
Development (debug build + launch; Buddy Bluetooth needs the .app below)
swift build && ./.build/debug/CodeIsland
Release (universal binary: Apple Silicon + Intel)
./build.sh open .build/release/CodeIsland.app
## Recent releases
- v1.0.31 (2026-07-23): English; ZCode approval buttons — allow / always allow / deny from the island; safely falls back to ZCode's own dialog when CodeIsland isn't running; restart ZCode once after updating (#258)
- v1.0.30 (2026-07-10): English; Add ZCode (Z.ai) integration — hooks written silently to ~/.zcode/cli/config.json with a strict event-name whitelist; restart ZCode after enabling (#245)
- v1.0.29 (2026-07-06): Highlights; New integrations OpenClaw (TypeScript plugin pack) and Claude Code Desktop — local Code-tab sessions recognition
- v1.0.28 (2026-06-15): English; Add Code Island Buddy companion app for iPhone & Apple Watch — Live Activity / Dynamic Island / Lock Screen / StandBy, with opt-in Mac broadcasting (#218)
- v1.0.27 (2026-05-30): Chinese; Fix cursor/workspace navigation and SSH remote host installation of CLI hooks (#199, #192)
## Traction
Stars: 2266; Forks: 259; Open issues: 20
## Behind the repo
CodeIsland is developed in Swift and licensed under MIT. The repository includes a macOS app and companion integrations for iPhone/Apple Watch.
## Caveats
License: MIT; Requires macOS 14.0+ (Sonoma) or later; Works best on MacBooks with a notch, but supports external displays