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!
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.
The agent harness performance optimization system. Skills, instincts, memory, security, and research-first development for Claude Code, Codex, Opencode, Cursor and beyond.
First-time install walkthrough for Claude Code, Codex CLI, and ChatGPT.
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.zip and unzip
Move Code Island.app to /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 /buddy pet 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 — ×3 badge 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,
The agent harness performance optimization system. Skills, instincts, memory, security, and research-first development for Claude Code, Codex, Opencode, Cursor and beyond.
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.
