v1.4.7 · macOS 14+ · Open source

Your AI coding agents,
live in the notch.

Monitor sessions, approve permissions, answer questions, and jump back to your terminal —
without ever leaving the notch. 17 AI coding agents in one place.

Download for macOS See how it works
Claude Code Codex Gemini Qwen Qoder Factory CodeBuddy Cursor Copilot Kimi OpenCode Cline Kiro Pi Oh My Pi AntiGravity Hermes
2
5h11%1h08m | 7d22%
ALL 2 CLAUDE 1 CODEX 1
CLAUDE (1)v
Code Island XHIGH <6m
"oh it works nice, but I just know that codex can do interactive question like claude ya"
✨ Using Bash · 1m 3s ⌘ iTerm2
CODEX (1)v
New project <5m
"can you create me a python script for odd and even number detection?"
✨ Thinking… · 8s ⌘ Terminal
5h11% | 7d22%
api-service 🔒 Needs approval
▣ Bash wants to execute a shell command
</> command40 chars
rm -rf ./dist && npm run build && npm test
5h3%4h19m | 7d23%4d
Code Island Waiting for answer
What should I theme the live question demo on the site after?
1 / 2 · single select
or type your own
›Type a custom answer...
How many session cards should fit in the List view demo?
2 / 2 · single select
or type your own
›Type a custom answer...
5h12% | 7d23%
deploy-script ✓ Finished in 3.2s
✨ Done replied to your message
you "deploy to staging"
↳ reply2 lines · 0.2kB

Deployed to staging cluster. Build finished in 47s, 12 files changed, smoke tests passed. Live at staging.api.dev.

⚙ Appearance Default
Code Island <6m
"five looks for the notch — same brains, your vibe."
✨ Thinking… ⌘ iTerm2
17 agents · 17 mascots one notch, every CLI
Claude
Claude
Codex
Codex
Gemini
Gemini
Qwen
Qwen
Qoder
Qoder
Factory
Factory
CodeBuddy
CodeBuddy
Cursor
Cursor
Copilot
Copilot
Kimi
Kimi
OpenCode
OpenCode
Cline
Cline
Kiro
Kiro
Pi
Pi
Oh My Pi
Oh My Pi
AntiGravity
AntiGravity
Hermes
Hermes
⌘ Jump to terminal click any card → straight to the tab
api-service ⌘ iTerm2
"run the test suite and show failures"
▼
iTerm2 — api-service
$ npm testPASS 12 suites · 0 failing$ ▏
Sound packs 8-bit chirps for every event
  • Session start
  • Completion
  • Approval needed
  • Error
  • Tool use
Import your own sounds in Settings → Sound

A live recreation — list, permission, question, finished, themes, mascots, jump-to, sound. Idle

FEATURES

Every agent. One glance.

Code Island surfaces the things you actually want to interrupt for — and only those.

◉

17 agents, side by side

From Claude & Codex to Gemini, Cursor, Copilot, Kiro, Pi and a dozen more — 17 agents. Filter chips, collapsible per-provider groups, jump between them instantly.

✓

Permission UI

Approve or deny without leaving your editor — buttons adapt per agent. Claude & Codex get Allow All + Bypass (session rules / prefix_rules); others show only what their hooks support, or hand off to the tool.

?

Question UI

Claude's AskUserQuestion answers inline with pill buttons. Codex's request_user_input mirrors in the notch with click-to-jump.

%

Live rate limits

Per-provider 5h and 7d windows. Color-coded warnings (green / yellow / orange / red). Tap to cycle between providers.

★

Finished reveal

When an agent finishes a task, the notch pops out with the response inline and a Done button. Auto-collapses after 3s.

⤢

Terminal jump

Click any session card to jump to the terminal or IDE running it. Works with iTerm2, Ghostty, Terminal.app, VS Code, JetBrains, Codex.app, and more.

♪

Sound packs

8-bit chiptune defaults with a per-event sound picker. Import your own .wav / .mp3 via "Add Sound…", assign them per event, and ▶ preview — no file-fiddling.

▣

Pixel mascots

Every agent gets its own hand-drawn pixel mascot — crab, gem, moon, robot, cat & more — that bounces while thinking and swaps color by status.

⏻

Smart cleanup

Process-PID sweep removes Claude sessions when the agent exits. For Codex we listen to the app-server's thread/closed events — works for both CLI and Codex.app.

↻

Auto updates

Weekly silent check against GitHub Releases. Pops an alert only when a newer version ships. Skip a release once and we won't nag again.

⌗

Zero config

Hooks for every detected provider install automatically on every launch. Idempotent. Run once, forget about it.

⌂

Fully local

No telemetry. No cloud. Bridge talks to the app over a Unix socket at /tmp/code-island.sock. Your code never leaves your Mac.

⌘

Native Swift

SwiftUI + AppKit. Lives at window layer 27 (just above the menu bar). No Electron, no web view, no JIT.

HOW IT WORKS

Hooks in. Decisions out.

An event-driven loop between the agent, a tiny CLI bridge, and the notch app — all over a local Unix socket.

  1. 1

    The agent fires a hook

    Claude Code or Codex fires SessionStart, PreToolUse, PermissionRequest, Stop — whatever's happening — and pipes JSON to a tiny bridge binary on stdin.

  2. 2

    The bridge enriches

    The bridge stamps source (claude / codex), captures the agent's PID, walks up the process tree to detect the terminal app, then forwards everything to the app over a Unix socket.

  3. 3

    The notch reacts

    A permission request? The notch pops out with the tool details and four buttons. A question? Pill buttons with multi-select. A Stop event? The agent's reply scrolls inline with auto-collapse.

  4. 4

    Your answer flows back

    The socket stays open until you click. Your decision serializes to JSON, lands on the bridge's stdout, and the agent continues — all in under a second.

PROVIDERS

Pick your agent. Or all seventeen.

Code Island treats every provider as a first-class citizen — its own mascot, palette, and quirks. Claude and Codex go deepest; here's the full lineup.

Claude Code

Anthropic's terminal coding agent

  • ✓ Session tracking & status
  • ✓ Permission request UI (4 buttons)
  • ✓ AskUserQuestion → pill buttons inline
  • ✓ Bypass via dontAsk mode
  • ✓ Allow-all via updatedPermissions
  • ✓ 5h / 7d rate limits (OAuth)
  • ✓ Pixel crab mascot

Codex

OpenAI's terminal + GUI agent

  • ✓ Session tracking & status
  • ✓ Permission request UI (4 buttons)
  • ✓ request_user_input mirror + jump
  • ✓ Allow-all via prefix_rule TOML
  • ✓ Works with CLI and Codex.app
  • ✓ 5h / 7d rate limits (ChatGPT auth)
  • ✓ Pixel terminal-box mascot

…and fifteen more — each with its own animated mascot, accent, and hooks:

Gemini CLI
Google · terminal
Qwen Code
Alibaba · permission UI
Qoder
Claude fork · permission UI
Factory
the droid CLI
CodeBuddy
Tencent · CLI
Cursor
the AI editor
Copilot
GitHub Copilot CLI
Kimi Code CLI
Moonshot AI
OpenCode
open source · permission UI
Cline
VS Code extension
Kiro
agentic IDE
Pi
extension · permission UI
Oh My Pi
Pi variant
AntiGravity
Google · IDE
Hermes
Nous Research
INSTALL

One DMG. Hooks auto-wire.

No config files. No env vars. Drop it in /Applications and start coding.

↓ Download latest DMG

Requires macOS 14 Sonoma or later

Free & open source under GPLv3 · LICENSE

Unsigned build? Clear Gatekeeper quarantine first 
xattr -cr "/Applications/Code Island.app"
Or build from source 
git clone https://github.com/rifqiakrm/code-island.git
cd code-island
swift build -c release
./scripts/build-dmg.sh 1.0.0
FAQ

Common questions

Is it really free?

Yes — it's free and open source under the GNU GPLv3. You can use, modify, and redistribute it; the only condition is that any distributed fork or derivative stays open source under GPLv3 too (no closed-source/proprietary forks).

Does my code or data leave my Mac?

No. Hook payloads stay on your machine. The bridge talks to the app over a local Unix socket. Rate limit checks hit Anthropic / OpenAI directly using your existing auth tokens — same as your CLI does — so the same TLS connection your agent already uses.

Which terminals work?

The bridge walks the process tree to find the GUI app that spawned the agent, so it works with anything that has a bundle ID — iTerm2, Ghostty, Terminal.app, VS Code, Cursor, Windsurf, JetBrains IDEs, Codex.app, and more. iTerm2 gets a tab-specific jump via ITERM_SESSION_ID.

How do hooks get installed?

On every launch, Code Island auto-installs hooks for each of the 17 agents it detects — writing each tool's own config (e.g. ~/.claude/settings.json, ~/.codex/hooks.json, plus the right format for Gemini, Cursor, Kimi, OpenCode, and the rest). It also picks up multiple Claude profiles (~/.claude-work, etc.). Idempotent and non-destructive — foreign hooks are preserved, the original is backed up, and you can delete the app or the hook files and let it rewrite them.

What if I don't have a notch?

It still works — on external displays or Macs without a notch, the panel shows as a compact bar at the top center of the screen. Hover to expand, leave to collapse — same UX, no physical notch needed.

How does this compare to Vibe Island?

Code Island is heavily inspired by Vibe Island — credit where it's due. Differences: this is open source (GPLv3), free, supports 17 AI coding agents, and is built from scratch in Swift — not a fork.

Why so many agents?

Because people mix and match — Claude for fast back-and-forth, Codex or a fork for longer runs, Cursor in the editor, a CLI for something else — and switching windows just to approve a Bash call was the original itch. One unified queue and a shared permission UI across all 17 agents saves dozens of context switches a day. Don't use most of them? Code Island only ever touches the ones it actually detects.

SUPPORT

Free forever. Fueled by ☕

Code Island is free and open source, built in spare time. If it's earned a spot in your notch and you'd like to support development, it genuinely means a lot — and it's completely optional.

Support on Ko-fi ☕ Donate via PayPal