# CodeIsland: a macOS notch panel for AI coding agents > CodeIsland puts live agent status, permission prompts and replies in the MacBook notch, connecting to 15 AI coding tools over Unix socket IPC. It is macOS-only, MIT-licensed, and the last push was on 2026-09-01. **wxtsky/CodeIsland** — Real-time AI coding agent status panel in your MacBook notch — live status, approvals & replies for 13 AI tools, with iPhone & Apple Watch companions - Repository: https://github.com/wxtsky/CodeIsland - Stars: 2,436 · Forks: 297 - Language: Swift - License: MIT - Published: 2026-09-10 · Updated: 2026-09-10 · Language: en - Canonical page: https://hysenlabs.com/projects/wxtsky-codeisland ## The window-switching problem CodeIsland targets An agent that stops to ask for permission is invisible until you look at it. CodeIsland's premise is that the MacBook notch is always on screen, so agent state belongs there rather than in a terminal tab you have to find. The README frames it plainly: no more switching windows to check if Claude is waiting for approval or if Codex finished a task. The audience is narrow and specific. You need a MacBook with a notch, macOS 14 or newer, and at least one of the 15 listed tools running locally. The repository is Swift, MIT-licensed, and the most recent release is v1.0.33 on 2026-09-01. Nothing here is a server component or a hosted service; the panel is a local app watching local processes. ## Unix socket IPC and per-tool event hooks The mechanism is hook injection plus IPC. On launch the app detects installed CLI tools and configures hooks for them automatically, with what the README calls auto-repair and version tracking. Those hooks report session events over a Unix socket, and the panel renders session status, tool calls, permission requests and responses. Coverage is uneven, and the README's own table admits it. Claude Code reports 13 events, Grok CLI 14, OpenCode reports all events, while Codex reports 3 and Cline 5. The status column marks Codex as Basic and most others as Full. Jump targets differ too: Claude Code jumps to a terminal tab, Cursor and Qoder to an IDE window, Cline to VSCode, CodeBuddy and OpenCode to an app or terminal. If your workflow depends on jumping back to the exact pane, check that row before installing. Notifications are suppressed at tab level rather than app level, which the README calls smart suppress. The distinction matters: if you have three terminals open and only one is running the blocked agent, the panel stays quiet for the other two. ## Installing via Homebrew and the first approval The README lists Homebrew as the recommended path. Two commands tap the repository and install the cask. ```bash brew tap wxtsky/tap brew install --cask codeisland ``` A manual route also exists: download CodeIsland.dmg from the Releases page, drag CodeIsland.app into Applications, and launch it. The README warns that macOS may show a security warning on first launch and that you clear it under System Settings, Privacy & Security, Open Anyway. After launch the app installs hooks for every detected AI tool on its own. Start an agent session in a terminal and the notch panel should expand with a session entry; when the agent requests a tool permission, the request appears in the panel and you approve or deny it there. The README describes answering agent questions from the panel as well, without leaving the current app. Optional pieces are configured in Settings. The Buddy section has an iPhone Buddy toggle labelled Allow iPhone Buddy to discover this Mac, plus a Sync interval control. The hardware Buddy switch drives an ESP32 screen over BLE, with parts and flashing steps in hardware/README.md, which the README notes is written in Chinese. ## What the notch panel cannot do The hard boundary is the operating system. This is a macOS app that renders into the notch; on a Mac without a notch the README's multi-display note says it auto-detects notch displays and works with external monitors, but the core UI assumption is a notch. Windows and Linux users have no path here, and the windows/ directory in the repository has no corresponding documentation. The second limitation is event depth per tool. Codex at 3 events and Cline at 5 events will not surface everything a 13-event integration does. The README does not say which events are missing for those tools, so you cannot tell in advance whether the gap is cosmetic or whether approvals never reach the panel. The third is hook ownership. Auto-install and auto-repair mean the app writes configuration into your CLI tools. The README does not document an uninstall procedure or a rollback for those hooks, and it does not say what happens when a tool changes its hook format between versions. Version tracking is mentioned, but its failure behaviour is not described. ## CodeIsland against terminal-native notification setups The obvious alternative is not another notch app but the notification path your terminal already has: shell hooks or the agent's own desktop notifications. That approach has no IPC layer, no socket, and no third-party process reading your session state. It also has no aggregation, so three agents produce three separate notification streams with no shared view, and no place to approve a permission request without focusing the originating window. CodeIsland's difference is that it centralises approvals and questions in one always-visible surface and adds jump-back to the originating tab, IDE window or agent pane. That is the trade: you gain a single control point and lose the property that nothing external observes your agent sessions. The companion apps extend the same model to iPhone, Apple Watch, an ESP32 display and, judging by the repository layout, an Android watch, though the README documents only the first three. ## Maintenance, releases and the MIT licence The last push to main was on 2026-09-01, the same day v1.0.33 was released. The two prior releases, v1.0.32 and v1.0.31, landed on 2026-08-15 and 2026-07-23, so the release cadence across that window is roughly every three weeks. The repository is not archived. Upgrade cost is low for the app itself: Homebrew cask upgrades and DMG replacement are the documented paths. The cost that is not documented is hook churn. Because the app configures hooks in every detected CLI tool and claims auto-repair, each tool upgrade is a potential reconfiguration event, and the README does not describe how conflicts with existing user hooks are resolved. The MIT licence permits commercial and closed-source use, modification and redistribution. What it does not do is grant rights to the bundled third-party CLI icons, mascot animations or the App Store listing, which the licence text in the repository is the place to check. This is a description of the licence, not legal advice. ## Conclusion Adopt CodeIsland if you run Claude Code, Codex, Cursor or several other agents on a MacBook and keep switching windows to check whether one is blocked on a permission prompt. Skip it if you work on Windows or Linux, or if you do not want an app installing hooks into every detected CLI tool. Before trusting it, verify two things: that your agent appears in the supported tools table with the event count you need, and that the auto-installed hooks survive your next tool upgrade. The repository layout includes windows/, android-watch/ and hardware/ directories, but the README documents none of them. ## FAQ ### Is CodeIsland free? The repository is MIT-licensed and the README states the Code Island Buddy companion is completely free and open source, with no account or external server required. The Mac app installs through a Homebrew cask or a DMG from the Releases page. ### Does CodeIsland run on Windows? No. CodeIsland is a macOS app that renders into the MacBook notch and its build requirements are macOS 14+ with Swift 5.9+. The repository contains a windows/ directory, but the README does not document any Windows build or usage. ### How does CodeIsland connect to AI coding tools? It connects over Unix socket IPC, using hooks that it installs automatically for all detected CLI tools. Those hooks report session status, tool calls and permission requests, which the notch panel then displays. ## Sources - [Issues](https://github.com/wxtsky/CodeIsland/issues) - [License: MIT](https://github.com/wxtsky/CodeIsland/blob/main/LICENSE) - [README](https://github.com/wxtsky/CodeIsland/blob/main/README.md) - [Releases](https://github.com/wxtsky/CodeIsland/releases) - [wxtsky/CodeIsland on GitHub](https://github.com/wxtsky/CodeIsland) --- Hysen Labs editorial analysis, written from the project's own repository and release notes. Cite the canonical page: https://hysenlabs.com/projects/wxtsky-codeisland