# wxtsky/CodeIsland

Real-time AI coding agent status panel in your MacBook notch — live status, approvals & replies for 13 AI tools, with iPhone & Apple Watch companions

Repository: https://github.com/wxtsky/CodeIsland
Canonical: https://ross.abutalabs.com/products/codeisland
Language: Swift
License: MIT
License Family: permissive
Topics: ai-agents, claude-code, developer-tools, dynamic-island, macos, notch, swift
Last push: 2026-08-15T06:32:02+00:00

## Health v2 (maintenance only)
Score: 80/100 (v2, computed 2026-09-02T17:46:02.011165+00:00)
- activity 97, release rhythm 98, longevity 10
- inputs: {"age_days": 149, "days_push": 18, "days_rel": 18, "gap_med": 0, "n_releases_24m": 32}
- flags: young
- formula: round(0.45*activity + 0.35*rhythm + 0.20*longevity); archived -> min(score, 10)

## Adoption (not part of the score)
Stars 2332, forks 276 (observed 2026-08-28T04:06:37.846370+00:00)

## What it is
CodeIsland is a macOS menu-bar/notch application that displays a real-time status panel for AI coding agents directly in the MacBook notch, styled like a Dynamic Island. It connects to 14 AI coding tools (Claude Code, Codex, Gemini CLI, Cursor, etc.) via Unix socket IPC to show session status, tool calls, and permission requests, with companion iPhone and Apple Watch apps.

## Use cases
- monitor AI coding agent status without switching windows
- approve or deny AI agent tool permission requests from the notch
- reply to AI agent questions while working in another app
- see when Claude Code or Codex finishes a task
- mirror AI agent session status to iPhone and Apple Watch
- jump directly to the terminal tab or IDE window of an active AI session

## When to choose
- you run multiple AI coding agents (Claude Code, Codex, Gemini CLI, etc.) on a MacBook with a notch
- you want to approve agent permission requests without leaving your editor
- you want live agent status on your iPhone or Apple Watch
- you prefer a native macOS app with pixel-art polish and bilingual UI

## When to avoid
- you use Linux or Windows instead of macOS
- your MacBook has no notch and you don't want a notch-style panel
- you only use AI tools not among the 14 supported integrations
- you need a cross-platform or CLI-only monitoring solution

## Facets
- artifact type: application
- maturity: active
- function: monitoring, developer-tools, gui
- domain: developer-tools, apple-ecosystem
- platform: -
- tags: dynamic-island, notch, macos-app, ai-coding-agents, apple-watch, status-panel, claude-code, permission-approvals, notification, ai-agents, macos, swift, ios, desktop

## Member repositories
- wxtsky/CodeIsland (main) score 80

## Provenance
- Observed fields: from GitHub, fetched 2026-08-28T04:06:37.846370+00:00.
- Health v2: computed from the inputs above; adoption is never an input.
- Inferred fields (summary, facets, guidance): AI-extracted, prompt v1, taxonomy v1, on 2026-08-30T02:37:57.814632+00:00, confidence not recorded.
  - readme: https://github.com/wxtsky/CodeIsland (fetched 2026-08-28T04:06:37.846370+00:00, sha 185b52f9ace9)
- Data as of 2026-08-30T08:39:29.467469+00:00.
