Code Island

"Wow, it's something only Windows can do!"

Who says Dynamic Island is only for macOS?
A Dynamic Island-style desktop companion for AI coding agents on Windows.

Tired of slacking off while your agent works, with no one to nudge you back?
Code Island delivers an immersive slacking-off experience!

English | 简体中文

Download · Promo Film · Features · UI Guide · How It Works · Usage · Project Structure

⚠️ This project is Windows-only. Code Island is a WPF (.NET 8) application inspired by Apple's Dynamic Island, designed to bring the same fluid, glanceable experience to Windows developers using AI coding agents like Claude Code and Cursor.

---

Promo Film

Watch the 32-second promo film

Features

• Real-time status: see when Claude Code is thinking, running tools, or waiting for input
• Permission approval: approve or deny tool executions (Bash, file edits, etc.) directly from the island
• Task completion alerts: sound + visual feedback when a task finishes or fails
• System monitor: live CPU & GPU utilization displayed above the island
• Multi-backend support: monitor Claude Code and Cursor sessions simultaneously
• Fullscreen auto-hide: automatically hides when a fullscreen app is detected (games, videos), pops back for permission requests
• Auto Retract (Notch mode): island slides into the top screen edge like a MacBook notch when idle — hover to reveal, right-click to toggle
• Global hotkeys: Ctrl+Shift+I toggle, Ctrl+Shift+A approve, Ctrl+Shift+D deny
• Fushi mascot: a pixel-art companion that changes expression based on task status

UI Guide

The island has several visual states, each designed to give you the right amount of information at a glance.

Mini Mode (default after idle)

A compact pill showing only the status dot and label. Appears after the island has been idle for a few seconds. Hover to expand.

Bar Mode (active state)

Element	Description
Fushi icon (left)	Pixel-art mascot, changes expression per state
Title	Model name, shows current tool when running (e.g. "Claude — Bash")
Subtitle	Status text: "Idle", "Working...", "Completed", "Error"
Dot (right)	Pulsing animation during running state
Glow border	Color matches status: orange (running), green (done), red (error)

Approval Card (permission request)

Expands automatically when Claude Code requests permission for a tool. Shows the tool name and the exact command or file path. Use the buttons or hotkeys (Ctrl+Shift+A / Ctrl+Shift+D) to respond.

Detail View (click to expand)

Shows all active sessions. Click a session row to switch the active backend.

Auto Retract (Notch Mode)

Right-click the island and enable Auto Retract — the island slides up into the screen edge when idle, leaving only a small notch visible (like a MacBook notch). Hover over the notch to slide it back out. You can also click Dock Now to retract immediately. The island automatically undocks when a new task starts or a permission request arrives.

Fushi States

State	Icon	Meaning
Idle		Waiting for input
Running		Processing or running a tool
Completed		Task finished successfully
Error		Task failed

How It Works

Claude Code CLI ──(hook)──> Python script ──(Named Pipe)──> Code Island UI
                                                                  │
                                                    Permission ◄──┘
                                                    Response

1. On first launch, Code Island installs a Python hook into ~/.claude/hooks/
2. When Claude Code fires an event (task start, tool use, permission request, etc.), the hook sends it to Code Island via Windows Named Pipe
3. Code Island updates the floating island UI in real time
4. For permission requests, the user approves/denies from the island, and the decision flows back through the pipe to Claude Code

Requirements

• Windows 10/11
• .NET 8.0 Runtime — Download
• Python 3.8+ — must be in PATH
• pywin32 — pip install pywin32
• Claude Code or Cursor (at least one)
• NVIDIA GPU (optional) — for GPU utilization display via nvidia-smi

Usage

Option 1: Download Release

1. Download from Releases
2. Extract to any folder
3. Run CodeIsland.exe

Option 2: Build from Source

git clone https://github.com/Iroha-P/Code-Island.git
cd Code-Island
dotnet publish src/CodeIsland/CodeIsland.csproj -c Release -r win-x64 --self-contained false -o publish

Run publish/CodeIsland.exe.

Hook Setup

On first launch, Code Island automatically:

1. Copies code-island-hook.py to ~/.claude/hooks/
2. Registers hooks in ~/.claude/settings.json for all relevant events

No manual configuration needed.

Project Structure

CodeIsland/
├─ src/CodeIsland/
│  ├─ App.xaml.cs                    # Application entry point
│  ├─ MainWindow.xaml(.cs)           # Island UI, animations, visual states
│  ├─ ViewModels/
│  │  └─ MainViewModel.cs            # State management, event routing
│  ├─ Models/                        # Data types (events, sessions, permissions)
│  ├─ Services/
│  │  ├─ Claude/                     # Claude Code backend (pipe + hook installer)
│  │  ├─ Cursor/                     # Cursor backend (process monitoring)
│  │  ├─ Shared/                     # Named Pipe server, backend interface
│  │  ├─ FullscreenDetectorService.cs # Auto-hide when fullscreen app detected
│  │  ├─ SystemMonitorService.cs     # CPU/GPU sampling
│  │  ├─ SoundService.cs            # System sound alerts
│  │  └─ TrayIconService.cs         # System tray
│  ├─ Interop/                       # Win32 P/Invoke (hotkeys, window positioning)
│  └─ Assets/                        # Hook script + Fushi sprites
└─ README*.md

Uninstall

1. Exit Code Island from the tray icon
2. Delete the application folder
3. Remove hook entries from ~/.claude/settings.json
4. Delete ~/.claude/hooks/code-island-hook.py

License

MIT

---

Star History

Report a Bug via Your Code Agent

Copy this prompt into your agent (Claude Code, Cursor, etc.) to auto-generate a well-structured issue:

Click to expand

I'm having an issue with Code Island (https://github.com/Iroha-P/Code-Island).

Please help me file a GitHub issue. Do the following:

1. Collect my environment info:

   • Run systeminfo | findstr /B /C:"OS Name" /C:"OS Version" to get Windows version
   • Run dotnet --version to get .NET version
   • Run python --version to get Python version
   • Check if Code Island is running: tasklist | findstr CodeIsland
   • Check which terminal I'm using

2. Ask me to describe:

   • What I expected to happen
   • What actually happened
   • Steps to reproduce

3. Create the issue on GitHub using gh issue create with this format:

   • Title: concise summary
   • Body with sections: Environment, Description, Steps to Reproduce, Expected vs Actual Behavior
   • Add label "bug" if applicable

Repository: Iroha-P/Code-Island