MioIsland

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

📱 Code Light — your iPhone companion 🐱✨

Note: Code Light is available on the App Store in 147 countries/regions. China mainland is currently unavailable due to pending ICP filing requirements. We are working on it.

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 the Code Light Sync module unlocks

MioIsland's Code Light Sync module turns 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. MioIsland 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. MioIsland 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 — MioIsland spawns a brand-new cmux workspace running that command | | 📷 Image attachments | Take photos with the iPhone camera; MioIsland 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 MioIsland — 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 MioIsland'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 live on the App Store (147 countries/regions, China mainland pending ICP filing). The MioIsland Sync module is included in v1.9.0+. ⭐ Star MioIsland + ⭐ Star Code Light to stay updated.

🐱 What MioIsland 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, 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 coding
• 18 species supported — duck, goose, blob, cat, dragon, octopus, owl, penguin, turtle, snail, ghost, axolotl, capybara, cactus, robot, rabbit, mushroom, chonk

Permission Approval

Approve or deny Claude Code's permission requests right from the notch:

• Code diff preview — see exactly what will change before allowing (green/red line highlighting)
• File path display — warning icon + tool name + file being modified
• Deny/Allow buttons — with keyboard hint labels
• Hook-based protocol — responses sent via Unix socket, no terminal switching needed

Pixel Cat Companion

A hand-drawn pixel cat with 6 animated states:

| State | Expression | |-------|-----------| | Idle | Black eyes, gentle bl