Every developer using Claude Code knows the pain: you have 5+ terminal sessions running, Claude is asking for permission in one tab, waiting for input in another, and you're buried in a third. You Alt-Tab frantically, lose context, and waste time.
So I built CodeIsland — a free, open-source macOS app that turns your MacBook's notch (Dynamic Island) into a real-time dashboard for all your AI coding agents.
The Problem
When you're running multiple Claude Code sessions across different projects, there's no way to see everything at a glance. You're constantly switching between terminals to:
- Check which session finished
- Approve permission requests
- Answer Claude's questions
- Monitor usage limits
Multiple Claude Code sessions in cmux, with CodeIsland monitoring everything from the notch
The Solution: Your Notch, Supercharged
CodeIsland lives in your MacBook's notch. When collapsed, it shows a tiny status indicator. When expanded, it becomes a full control panel.
Session list showing active projects, terminal tags, usage stats, and your Claude Code buddy
What You Can Do From the Notch
1. Monitor All Sessions
Every Claude Code session appears in a clean list with:
- Color-coded terminal tags (cmux blue, Ghostty purple, iTerm green)
- Active sessions highlighted with accent backgrounds
- Real-time tool tracking and subagent status
2. Claude Usage Monitoring
Real-time 5h/7d usage percentage pulled directly from Anthropic's OAuth API. No plugins needed — reads your token from macOS Keychain.
5h 22% and 7d 30% usage with progress bars and reset timers
3. Chat History & Code Diffs
Click any session to see the full conversation, including tool calls with status indicators and code diffs with green/red highlighting.
Full conversation view with tool calls, code edits, and "Go to Terminal" button
4. Meet Your Buddy
Full integration with Claude Code's /buddy system. See your companion's species, rarity, stats, and personality.
Legendary Octopus "Kris" with full ASCII art and stat bars
5. Smart Settings
Compact two-column layout with everything you need.
Clean settings with Star & Feedback buttons — v1.8.0
Smart Features That Matter
Smart Popup Suppression
The most annoying thing about notification apps? They interrupt you when you're already looking at the thing they're notifying about.
CodeIsland detects which terminal tab you're currently viewing. If a Claude session finishes in a cmux workspace you're already looking at, it won't popup. It only alerts you about sessions you can't see.
Supported: cmux (workspace-level), iTerm2 (session-level), Ghostty (window-level), Terminal.app (tab-level).
AskUserQuestion Quick Reply
When Claude asks you a multiple-choice question, the options appear as buttons directly in the notch. Click one, and the answer is sent to your terminal automatically via cmux send — no window switching needed.
One-Click Terminal Jump
Every session has a green terminal button. Click it, and CodeIsland finds the exact cmux workspace (or iTerm tab, or Ghostty window) and brings it to front.
Subagent Tracking
When Claude spawns subagents, you see them in real-time with ⚡ badges and collapsible detail views showing each agent's task.
Terminal Support
| Terminal | Detection | Jump | Quick Reply | Smart Suppression |
|---|---|---|---|---|
| cmux | Auto | Workspace-level | ✅ | Workspace-level |
| iTerm2 | Auto | AppleScript | ✅ | Session-level |
| Ghostty | Auto | AppleScript | - | Window-level |
| Terminal.app | Auto | Activate | ✅ | Tab-level |
| Warp | Auto | Activate | - | - |
| VS Code | Auto | Activate | - | - |
| + 5 more | Auto | Activate | - | - |
Tech Stack
- Swift + SwiftUI — Native macOS, ~70 Swift files
- Unix Socket — Hook events from Claude Code via Python bridge
- Anthropic OAuth API — Direct usage stats, no middleware
- macOS Keychain — Zero-config authentication
- AppleScript — Terminal detection and control
Get It
It's completely free and open-source. No commercial intentions — just a passion project.
git clone https://github.com/xmqywx/CodeIsland.git
cd CodeIsland
xcodebuild -scheme ClaudeIsland -configuration Release build
GitHub: github.com/xmqywx/CodeIsland
Works best with cmux — the modern terminal multiplexer built on Ghostty.
If you find it useful, a ⭐ on GitHub would mean the world. It's what keeps us shipping updates.
Built entirely with Claude Code, of course. 🐱
Top comments (0)