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 支持一下！这是我们持续更新的最大动力。

📱 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.

A native macOS app that turns your MacBook's notch into a real-time control surface for AI coding agents. Monitor sessions, approve permissions, jump to terminals, and hang out with your Claude Code buddy — all without leaving your flow.

📱 New: pairs with Code Light — your iPhone companion

CodeIsland now includes a built-in sync module that pairs with the Code Light iPhone app. From your phone you can:

• See every Claude Code session live, with the iPhone Dynamic Island showing the current phase
• Send any text message — including all /slash commands like /model, /cost, /usage, /clear
• Spawn brand-new cmux workspaces remotely with one tap (Mac-defined launch presets)
• Send images via camera or photo library (auto-pasted into the cmux pane)
• Pair multiple iPhones to the same Mac, or one iPhone to many Macs — your phone tracks them all

Pairing is one permanent 6-character code per Mac (or scan a QR). No accounts, no QR expiry, no re-pair after reboot. See the Code Light Sync section below.

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, SNARK) computed using the exact same Bun.hash + Mulberry32 algorithm as Claude Code
• Dynamic salt detection — reads the actual salt from your Claude Code binary, supports patched installs (any-buddy compatible)
• ASCII art sprite — all 18 buddy species rendered as animated ASCII art with idle animation sequence (blink, fidget), matching Claude Code's terminal display
• Buddy card — left-right layout: ASCII sprite + name on the left, ASCII stat bars [████████░░] + personality on the right
• Rarity stars — ★ Common to ★★★★★ Legendary with color