CodeIsland
by xmqywx
macOS Dynamic Island for AI coding agents. Monitor, approve, and jump to Claude Code sessions from the notch.
154stars
27forks
Swift
Added 4/8/2026
AI Agentsai-codinganthropicclaudeclaude-codecoding-agentdeveloper-toolsdynamic-islandmacosmenubarnotchproductivityswiftswiftuivibe-coding
Installation
# Add to your Claude Code skills
git clone https://github.com/xmqywx/CodeIslandGetting Started
Guides for using ai agents skills like CodeIsland.
- Caveman: Cut Claude Token Use by 65%How agent-side prompt compression works, when to use it, and when not to.
- What is an AI Skills Marketplace?Definitions, how marketplaces work, and how to choose between them in 2026.
- Getting Started with AI SkillsFirst-time install walkthrough for Claude Code, Codex CLI, and ChatGPT.
Security ReportVerified
Last scanned: 5/30/2026
{
"issues": [],
"status": "PASSED",
"scannedAt": "2026-05-30T16:02:16.234Z",
"npmAuditRan": true,
"pipAuditRan": true
}CodeIsland
Your 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.
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):
- Download
CodeIsland-vX.Y.Z.zipand unzip- Move
Code Island.appto/Applications- Right-click the app → Open → click Open in the dialog
- Subsequent launches will work normally with a double-click
Option 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.
⚠️ 安装说明（v1.9.0-rc1 及后续版本）
最新版本已使用 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 处理完后，后续版本将恢复正常双击安装体验。感谢理解。
📱 Coming Soon: Code Light — your iPhone companion 🐱✨
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.
What CodeIsland's next version unlocks
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.
🐱 What CodeIsland looks like today
The collapsed notch — pixel cat companion, current status text, and an active-session badge. Always visible, never in the way.
Features
Dynamic Island Notch
The collapsed notch shows everything at a glance:
- Animated buddy — your Claude Code
/buddypet rendered as 16x16 pixel art with wave/dissolve/reassemble animation - Status dot — color indicates state:
- 🟦 Cyan = working
- 🟧 Amber = needs approval
- 🟩 Green = done / waiting for input
- 🟣 Purple = thinking
- 🔴 Red = error, or session unattended >60s
- 🟠 Orange = session unattended >30s
- Project name + status — carousel rotates task title, tool action, project name
- Session count —
×3badge showing active sessions - Pixel Cat Mode — toggle to show the hand-drawn pixel cat instead of your buddy
Session List
Expand the notch to see all your Claude Code sessions:
- Pixel cat face per session with state-specific expressions (blink, eye-dart, heart eyes on done, X eyes on error)
- Auto-detected terminal — shows Ghostty, Warp, iTerm2, cmux, Terminal, VS Code, Cursor, etc.
- Task title — displays your first message or Claude's summary, not just the folder name
- Duration badge — how long each session has been running
- Golden jump button — click to jump to the exact terminal tab (via cmux/Ghostty AppleScript)
- Glow dots with gradient dividers — minimal, clean design
- Hover effects — row highlight + golden terminal icon
Claude Code Buddy Integration
Full integration with Claude Code's /buddy companion system:
- Accurate stats — species, rarity, eye style, hat, shiny status, and all 5 stats (DEBUGGING, PATIENCE, CHAOS, WISDOM,
Frequently Asked Questions
What is CodeIsland?
CodeIsland is an open-source ai agents skill for AI coding assistants such as Claude Code, Codex CLI, and ChatGPT, built by xmqywx. macOS Dynamic Island for AI coding agents. Monitor, approve, and jump to Claude Code sessions from the notch. It has 154 GitHub stars.
Is CodeIsland safe to use?
Yes. CodeIsland passed SkillsLLM's automated security scan — a dependency vulnerability audit plus prompt-injection heuristics — with no high-severity issues. You can read the full report in the Security Report section on this page.
How do I install CodeIsland?
Clone the repository with "git clone https://github.com/xmqywx/CodeIsland" and add it to your Claude Code skills directory (see the Installation section above).
What programming language is CodeIsland written in?
CodeIsland is primarily written in Swift. It is open-source under xmqywx on GitHub, so you can review or fork the full source.
Are there alternatives to CodeIsland?
Yes. SkillsLLM lists many other AI Agents skills you can browse and compare side by side. Open the AI Agents category from the badge at the top of this page, or use the Related Skills and comparison links further down to weigh CodeIsland against similar tools.
Comments (0)
to leave a comment.
No comments yet. Be the first to share your thoughts!
Related Skills
An agentic skills framework & software development methodology that works.
234,966
20,863
Shell
AI Agentsaibrainstorming
The agent harness performance optimization system. Skills, instincts, memory, security, and research-first development for Claude Code, Codex, Opencode, Cursor and beyond.
226,748
34,674
JavaScript
AI Agentsai-agentsanthropic
The agent harness performance optimization system. Skills, instincts, memory, security, and research-first development for Claude Code, Codex, Opencode, Cursor and beyond.
185,940
28,768
JavaScript
AI Agentsai-agentsanthropic
Claude Code is an agentic coding tool that lives in your terminal, understands your codebase, and helps you code faster by executing routine tasks, explaining complex code, and handling git workflows - all through natural language commands.
120,031
19,897
Shell
AI Agents
A cross-platform desktop All-in-One assistant for Claude Code, Codex, OpenCode, OpenClaw, Gemini CLI & Hermes Agent. Only official website: ccswitch.io
114,101
7,614
Rust
AI Agentsai-toolsclaude-code