Skip to content

lordmos/copilot-island

Repository files navigation

Copilot Island 🏝️

Copilot Island Logo

Bring GitHub Copilot CLI to your MacBook Notch
Monitor sessions and browse chat history — all from the notch.

Latest Release Apache 2.0 macOS 14+ Swift 5.9 Documentation

简体中文 · 繁體中文 · 日本語 · 한국어 · Français · Deutsch · Português · Español


What is Copilot Island?

Copilot Island is a free, open-source macOS notch app that lives in your MacBook's notch and shows you everything GitHub Copilot CLI is doing — in real time.

Inspired by ClaudeIsland, Copilot Island brings the same elegant notch-based UI to GitHub Copilot CLI users.

Features

Feature Description
🔔 Live Sessions Auto-detects all active Copilot CLI sessions
Tool Feed See every tool call (read_file, run_command, etc.) as it happens
💬 Chat History Browse full conversation with Markdown rendering
🎨 Sage Green Design Muted sage-green palette, dark theme, fluid animations
🔒 Private & Secure No analytics, no telemetry, runs 100% on-device

Requirements

  • macOS 14.0+ (Sonoma or later)
  • MacBook Pro or MacBook Air with notch (2021 or later)
  • GitHub Copilot CLI installed

Installation

Download

Go to Releases and download the latest CopilotIsland.dmg.

Build from Source

git clone https://github.com/lordmos/copilot-island.git
cd copilot-island/copilot-island-project
chmod +x scripts/setup.sh && ./scripts/setup.sh
open CopilotIsland.xcodeproj

Requirements for building: Xcode 15+, macOS 14+, Homebrew (for XcodeGen).

How It Works

Copilot Island watches ~/.copilot/session-state/ — Copilot CLI's native session directory — using macOS FSEvents. Every event (session start, user message, tool call, tool result) is streamed from events.jsonl files with zero latency.

~/.copilot/
├── session-state/
│   └── {UUID}/
│       ├── workspace.yaml    ← session metadata (cwd, branch, etc.)
│       └── events.jsonl      ← append-only event stream ← watched by Copilot Island

No Python hooks. No CLI modification. No configuration.

Architecture

CopilotIsland/
├── App/                    # SwiftUI App entry point + AppDelegate
├── Models/                 # CopilotEvent, SessionState, SessionPhase
├── Services/
│   ├── Session/            # CopilotSessionWatcher (FSEvents) + Monitor
│   ├── State/              # SessionStore (Swift Actor)
│   └── Update/             # SparkleUpdater
├── Core/                   # NotchViewModel + NotchGeometry + Settings
├── Events/                 # Mouse event monitors
└── UI/
    ├── Window/             # NotchWindow (NSPanel)
    ├── Components/         # NotchShape + CopilotTheme (sage green)
    └── Views/              # NotchView, SessionsListView, ChatHistoryView,
                            #   MenuView

⭐ Star History

Star History Chart

Contributing

We welcome contributions! See CONTRIBUTING.md for guidelines.

License

Apache License 2.0 — see LICENSE for details.


Made with ❤️ by lordmos and AI teammates

About

A Open Source Claude Island for GitHub Copilot User

Resources

License

Contributing

Stars

Watchers

Forks

Packages

 
 
 

Contributors