Dynamic Island.Dynamic Island/daɪˈnæmɪk ˈaɪlənd/nounA pill-shaped, interactive region at the top of the screen that surfaces live activities and status. Introduced by Apple in 2022.
For your agent.agent/ˈeɪdʒənt/nounAn autonomous program that perceives its environment and acts toward a goal — here, an AI coding assistant living in your terminal.
pi-island turns the top of your screen into a live status capsule for the pi coding agent. Native on macOS (WKWebView) and Windows (WebView2), notch-aware on MacBooks, one row per session — pinned, stacked, and always in sight.
Install
macOS / WindowsRequires pi plus the toolchain for your platform — Xcode Command Line Tools on macOS, the .NET 8 SDK on Windows.
Settings
inside any pi sessionType /island to open the settings panel. Cycle any row with Enter or Space. Choices persist in ~/.pi/pi-island.json.
Visibilityenabled / disabled — show or hide the capsule. Remembers your choice.
Sizesmall / medium / large / xlarge — row height and font scale together. Live, no restart.
Screenprimary / active / 2 / 3 — pick a monitor. primary = menu-bar display, active = follow mouse.
Notch wrapauto / normal / notch — wrap the MacBook notch automatically, or force it on/off.
Skip the menu for muscle memory: /island size large, /island screen primary, /island notch notch, /island off.
Run pi in multiple terminals — each session gets its own row, stacked into one continuous capsule.
How it works
- 1.
A native host per platform renders a borderless, click-through WebView pinned above every window — Swift + WKWebView on macOS, C# + WebView2 on Windows.
- 2.
pi's extension API streams each turn's status over a local socket to the host.
- 3.
Every pi session gets its own row. Rows stack into a single capsule, sized to the longest row.
- 4.
Notch detection on MacBooks with a notch, the capsule splits to wrap around it automatically — or force it on/off from the settings menu.
- 5.
Zero chrome. No dock icon, no taskbar entry, no Stage Manager clutter — it just lives at the top.