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,