by xmqywx
macOS Dynamic Island for AI coding agents. Monitor, approve, and jump to Claude Code sessions from the notch.
# Add to your Claude Code skills
git clone https://github.com/xmqywx/CodeIslandYour AI agents live in the notch.
This is a passion project built purely out of personal interest. It is free and open-source with no commercial intentions whatsoever. I welcome everyone to try it out, report bugs, share it with your colleagues, and contribute code. Let's build something great together!
这是一个纯粹出于个人兴趣开发的项目,完全免费开源,没有任何商业目的。欢迎大家试用、提 Bug、推荐给身边的同事使用,也欢迎贡献代码。一起把它做得更好!
English | 中文
If you find this useful, please give it a star! It keeps us motivated to improve.
如果觉得好用,请点个 Star 支持一下!这是我们持续更新的最大动力。
⚠️ Installation Notice (v1.9.0-rc1 and later)
The latest builds are code-signed with our Developer ID but not yet notarized by Apple. We are actively working with Apple to resolve a server-side issue (notarization error 7000) on their end. The app binary is identical to previous notarized releases — only the Apple notary ticket is missing.
No comments yet. Be the first to share your thoughts!
System requirement: macOS 15.0 or later (universal binary, supports both Apple Silicon and Intel).
First launch — choose one:
Option A — Right-click to open (recommended):
CodeIsland-vX.Y.Z.zip and unzipCode Island.app to /ApplicationsOption B — Command line (one-liner):
xattr -dr com.apple.quarantine "/Applications/Code Island.app" && open "/Applications/Code Island.app"
Once Apple resolves the notarization issue, future releases will install with a normal double-click. Thank you for your patience.
最新版本已使用 Developer ID 签名,但暂未完成 Apple 公证。我们正在积极联系 Apple 处理后台的配置问题(公证错误 7000)。应用代码与之前已公证的版本完全一致,仅缺少 Apple 公证票。
系统要求: macOS 15.0 或更高(通用二进制,同时支持 Apple Silicon 和 Intel 芯片)。
首次打开 —— 任选一种方式:
方式 A —— 右键打开(推荐):
CodeIsland-vX.Y.Z.zip 并解压Code Island.app 拖到 /应用程序(Applications)方式 B —— 终端命令(一行搞定):
xattr -dr com.apple.quarantine "/Applications/Code Island.app" && open "/Applications/Code Island.app"
Apple 处理完后,后续版本将恢复正常双击安装体验。感谢理解。
Claude is thinking. You're at lunch. You'll know.
The same pixel cat that lives in your Mac's notch now lives in your iPhone's Dynamic Island. Real-time session phase, latest user question, and Claude's reply preview — right on your lock screen.
The next CodeIsland release ships the Code Light Sync module — turning the notch app into a bidirectional bridge between your Mac, the cloud, and your iPhone:
| Feature | What it means for you |
|---|---|
| 🏝️ Real Dynamic Island | A live ActivityKit activity reflects "what Claude is doing right now" in your iPhone's notch — phase, tool name, elapsed time |
| 🎯 Pinpoint terminal routing | Phone messages land in the exact Claude pane you picked. CodeIsland walks ps -Ax → finds the live claude --session-id PID → reads CMUX_WORKSPACE_ID/CMUX_SURFACE_ID env vars → cmux send --workspace --surface. Zero guessing |
| ⚡ Slash commands round-trip | Type /model, /cost, /usage, /clear from the phone. CodeIsland snapshots the cmux pane, injects the command, diffs the output, and ships it back as a chat message. You see the response as if it were a Claude reply |
| 🚀 Remote session launch | Tap + on the phone, pick a launch preset (claude --dangerously-skip-permissions --chrome), pick a project — CodeIsland spawns a brand-new cmux workspace running that command |
| 📷 Image attachments | Take photos with the iPhone camera; CodeIsland downloads the blob and pastes via NSPasteboard + AppleScript Cmd+V into the cmux pane |
| 🔐 Permanent 6-char pair code | Each Mac gets a permanent shortCode (lazy-allocated, never rotates). Restart CodeIsland — code is the same. Pair another iPhone — same code, same Mac |
| 🖥️ One Mac, many iPhones · One iPhone, many Macs | DeviceLink graph in the server. A Mac can be paired with N iPhones; an iPhone can be paired with M Macs across different backend servers |
| 🔄 60-second echo dedup ring | Phone-injected text doesn't bounce back as a duplicate when CodeIsland's JSONL watcher re-detects it |
| 🌐 Self-hostable, zero-knowledge | Run your own CodeLight Server on any VPS. The relay stores only encrypted blobs |
Status: Code Light is currently in TestFlight, App Store submission in flight. The CodeIsland Sync module ships as part of the next public release. ⭐ Star CodeIsland + ⭐ Star Code Light to be notified.
The collapsed notch — pixel cat companion, current status text, and an active-session badge. Always visible, never in the way.
The collapsed notch shows everything at a glance:
/buddy pet rendered as 16x16 pixel art with wave/dissolve/reassemble animation×3 badge showing active sessionsExpand the notch to see all your Claude Code sessions:
Full integration with Claude Code's /buddy companion system: