← all repositories
MioMioOS/MioIsland

Claude Code sets up camp in the MacBook notch

MioIsland parks Claude Code in your MacBook notch so you can monitor sessions and approve permissions without switching windows.

MioIsland
Not currently ranked — collecting fresh signals.
star history

What it does MioIsland is a macOS utility that hooks into Claude Code terminal sessions and projects live status—active tasks, session lists, and permission requests—into the Dynamic Island and menu bar. It acts as a native SwiftUI bridge, letting you glance at agent activity or tap to approve and deny prompts without tabbing back to a terminal. The project also pushes state to an iPhone companion app for remote monitoring and launching.

The interesting bit Rather than building yet another IDE panel, the author turned the MacBook notch into a dedicated heads-up display for an AI agent, piping terminal events through a local Unix socket (/tmp/codeisland.sock) and broadcasting updates via cmux. It is fundamentally ambitious glue code, but it is dressed up with a pixel-cat mascot and 8-bit sound effects that acknowledge how silly—and useful—a notch-resident coding supervisor can be.

Key highlights

  • Surfaces Claude Code status, session lists, and permission allow/deny prompts directly in the macOS Dynamic Island.
  • Hooks terminal events and forwards them through a Unix socket to support remote launch and bidirectional iPhone sync.
  • Supports a wide roster of terminals and editors: cmux, iTerm2, Ghostty, Terminal.app, Warp, Kitty, WezTerm, VS Code, Cursor, and Zed.
  • Ships with a pixel cat mascot and 8-bit sound effects, because even glue code deserves personality.
  • Licensed CC BY-NC 4.0 (personal use only; commercial use prohibited) and forked from an earlier project called Claude Island.

Caveats

  • The README is entirely image-based, so most technical details live in alt text and screenshots; expect to hunt for specifics.
  • The CC BY-NC 4.0 license forbids commercial use, which rules out most office workstations unless your employer explicitly approves.
  • Requires macOS 15+ and Accessibility permissions, standard for this class of tool but still a notable constraint.

Verdict Worth a look if you spend hours in Claude Code and want a native, at-a-glance supervisor living in your menu bar. Skip it if you need a commercially licensed tool or rarely deal with agent permission prompts.

Frequently asked

What is MioMioOS/MioIsland?
MioIsland parks Claude Code in your MacBook notch so you can monitor sessions and approve permissions without switching windows.
Is MioIsland open source?
Yes — MioMioOS/MioIsland is an open-source project tracked on heatdrop.
What language is MioIsland written in?
MioMioOS/MioIsland is primarily written in Swift.
How popular is MioIsland?
MioMioOS/MioIsland has 516 stars on GitHub.
Where can I find MioIsland?
MioMioOS/MioIsland is on GitHub at https://github.com/MioMioOS/MioIsland.

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