A tiny friend in your Mac's notch and on your iPhone that keeps an eye on your AI coding agents: Claude Code, Codex, Cursor, Gemini CLI, Antigravity and more. Approve from the notch or your Lock Screen.
Swift ai-agentsanthropicantigravityclaudeclaude-codecodexcursordynamic-islandgemini-cliiosiphonlinuxmacosmacos-appmenubar-appnotchopen-sourceswiftswiftuiwindows
import Foundation
// MARK: - Island Mode
enum IslandMode: String, CaseIterable {
case hidden, compact, expanded
}
// MARK: - Island View
enum IslandView: String, CaseIterable {
case overview, empty, approval, question, error, finished
case confused, upload, uploading, choose, mail, prompt
case searching, result, note, settings, greeting, wardrobe, recap
case listening // voice wake detected — "À l'écoute…" with live transcript
case voiceResult // voice command executed — "✓ Musique lancée" for ~2 s
case capture // a screen capture just taken (⌃⌥X): paste, copy, annotate, ask Claude
case update // a new Coucou is out on GitHub: one click to install it (GitHub build)
case whatsNew // Coucou just updated itself: what the version brings, then your Coucou so far (GitHub build)
}
// MARK: - Bot State
enum BotState: String, CaseIterable {
case idle, working, thinking, searching
case approval, question, error, finished
case ratelimit, sleeping, dizzy
}
// MARK: - Bot Emote
enum BotEmote: String, CaseIterable {
case love, surprised, proud, wink, yawn, happy, annoyed
case listening // attentive: head tilt + wide-open eyes
}
// MARK: - Voice sub-state
/// What Mochi is doing during a voice exchange (compact island or expanded).
/// Driven by IslandWindowController; read by BotEngine each frame.
enum BotVoiceSubState: Equatable {
case none // voice not active
case listening // mic open, waiting for words
case thinking // command received, waiting for AI / TTS queue to drain
case speaking // TTS audio playing
}
// MARK: - Approval info (pending PermissionRequest from Claude Code)
struct ApprovalInfo: Sendable {
var sessionId: String
var tool: String
var command: String
/// tool_input serialized to JSON with sortedKeys, "" if absent — used to match PostToolUse.
var inputKey: String
/// Pill that owns this approval: "integration_claude", "agent_cursor", or "agent_codex".
var pillId: String
/// Queued request this card answers (Mac): a decision is only accepted for this id.
var id: UUID = UUID()
/// Requests waiting, this one included; the card shows the count when above 1.
var queueCount: Int = 1
/// Project of the session that asks (several sessions can share one pill).
var projectName: String = ""
}
// MARK: - Pill badge (shown on pill edge when non-focused task has an alert)
enum PillBadge { case approval, finished, error }
// MARK: - Agent Task
struct AgentTask: Identifiable, Equatable {
var id: String
var name: String
var color: String // hex
var state: BotState
var stepIndex: Int = 0
var steps: [String]
var source: AgentSource
var isIntegration: Bool = false // true for persistent integration pills
var emote: BotEmote? = nil
var miniEye: EyeShape? = nil
var pillBadge: PillBadge? = nil // alert badge shown on pill when not focused
var sessionCwd: String? = nil // last known working directory (Claude Code sessions)
var sessionBundleId: String? = nil // app the session runs in (hook bundle_id), for "Open terminal"
var finalLine: String? = nil // last assistant message shown as static text after Stop
var hostApp: String? = nil // bundle id of the terminal running a Claude Code session; nil = VS Code
/// The sessions sharing this pill, for the open card; empty while one session (or none) is behind it.
var sessionLines: [SessionLine] = []
/// The client pill this task belongs to: its id, or for a session's own pill
/// ("integration_claude#2") the pill of its client. Compare this, not `id`, to a pill ID.
var pill: String { PillCatalog.basePillId(id) }
}
/// One of several sessions behind a pill, as the open card lists them.
struct SessionLine: Identifiable, Equatable {
var id: String
var title: String
var state: BotState
var lastStep: String
/// The session the pill shows (its name, steps and state are the pill's).
var isShown: Bool
}
enum AgentSource: Equatable {
case claudeCode
case n8n
case agent // third-party agent via coucou_agent field
}
// MARK: - Chat provider
enum ChatProvider: String, CaseIterable, Codable {
case anthropic = "anthropic"
case google = "google"
case openai = "openai"
case ollama = "ollama"
case lmstudio = "lmstudio"
case deepseek = "deepseek"
case qwen = "qwen"
case moonshot = "moonshot"
// Answered only through the user's own subscription (CLIRelay.swift, GitHub build)
case cursor = "cursor"
case copilot = "copilot"
var displayName: String {
switch self {
case .anthropic: "Anthropic"
case .google: "Google"
case .openai: "OpenAI"
case .ollama: "Ollama"
case .lmstudio: "LM Studio"
case .deepseek: "DeepSeek"
case .qwen: "Qwen"
case .moonshot: "Moonshot"
case .cursor: "Cursor"
case .copilot: "GitHub Copilot"
}
}
var accentHex: String {
switch self {
case .anthropic: "#E07950"
case .google: "#4285F4"
case .openai: "#10A37F"
case .ollama: "#FACC15"
case .lmstudio: "#A3E635"
case .deepseek: "#5B8FF9"
case .qwen: "#FF6A00"
case .moonshot: "#7C5CFC"
case .cursor: "#A1A1AA"
case .copilot: "#8B5CF6"
}
}
var defaultModel: String {
switch self {
case .anthropic: "claude-sonnet-4-6"
case .google: "gemini-2.0-flash"
case .openai: "gpt-4o"
case .ollama: "llama3.2"
case .lmstudio: "local-model"
case .deepseek: "deepseek-chat"
case .qwen: "qwen-max"
case .moonshot: "moonshot-v1-32k"
case .cursor: ""
case .copilot: ""
}
}
var keychainKey: String {
switch self {
case .anthropic: "anthropic-api-key"
case .google: "google-api-key"
case .openai: "openai-api-key"
case .ollama: ""
case .lmstudio: ""
case .deepseek: "deepseek-api-key"
case .qwen: "qwen-api-key"
case .moonshot: "moonshot-api-key"
case .cursor: ""
case .copilot: ""
}
}
var isLocal: Bool {
self == .ollama || self == .lmstudio
}
var pillID: String {
switch self {
case .anthropic: "ai_anthropic"
case .google: "ai_google"
case .openai: "ai_openai"
case .ollama: "ai_ollama"
case .lmstudio: "ai_lmstudio"
case .deepseek: "ai_deepseek"
case .qwen: "ai_qwen"
case .moonshot: "ai_moonshot"
case .cursor: "ai_cursor"
case .copilot: "ai_copilot"
}
}
init?(pillID: String) {
switch pillID {
case "ai_anthropic": self = .anthropic
case "ai_google": self = .google
case "ai_openai": self = .openai
case "ai_ollama": self = .ollama
case "ai_lmstudio": self = .lmstudio
case "ai_deepseek": self = .deepseek
case "ai_qwen": self = .qwen
case "ai_moonshot": self = .moonshot
case "ai_cursor": self = .cursor
case "ai_copilot": self = .copilot
default: return nil
}
}
}
// MARK: - View dimensions (from VIEWS in prototype)
struct ViewLayout {
let height: CGFloat
let botX: CGFloat
let botY: CGFloat? // nil = auto-centered
let botDiameter: CGFloat
let agentMode: AgentLayoutMode
}
enum AgentLayoutMode {
case none, grid, pills, column
}
// MARK: - Constants (from NW, NH, EW in prototype)
enum IslandConst {
static let notchWidth: CGFloat = IslandScreenGeometry.fallbackNotchWidth
static let notchHeight: CGFloat = 32
static let expandedWidth: CGFloat = 640
static let earRadius: CGFloat = 14
static let roundedCorner: CGFloat = 14 // hidden/peek/compact
static let expandedCorner: CGFloat = 22
static let viewLayouts: [IslandView: ViewLayout] = [
// Home is the reference: height 150
.overview: ViewLayout(height: 160, botX: 68, botY: nil, botDiameter: 58, agentMode: .pills),
// All non-chat views match home height (150) — law
.empty: ViewLayout(height: 160, botX: 70, botY: nil, botDiameter: 62, agentMode: .none),
.approval: ViewLayout(height: 160, botX: 62, botY: nil, botDiameter: 56, agentMode: .column),
.question: ViewLayout(height: 160, botX: 62, botY: nil, botDiameter: 56, agentMode: .column),
.error: ViewLayout(height: 160, botX: 62, botY: nil, botDiameter: 58, agentMode: .column),
.finished: ViewLayout(height: 160, botX: 62, botY: nil, botDiameter: 58, agentMode: .column),
.confused: ViewLayout(height: 160, botX: 76, botY: nil, botDiameter: 66, agentMode: .column),
.upload: ViewLayout(height: 176, botX: 140, botY: 104, botDiameter: 62, agentMode: .column),
.uploading: ViewLayout(height: 176, botX: 46, botY: 118, botDiameter: 20, agentMode: .none),
.choose: ViewLayout(height: 176, botX: 60, botY: 101, botDiameter: 52, agentMode: .column),
.mail: ViewLayout(height: 240, botX: 56, botY: nil, botDiameter: 46, agentMode: .column),
.prompt: ViewLayout(height: 160, botX: 52, botY: nil, botDiameter: 44, agentMode: .column),
.searching: ViewLayout(height: 160, botX: 52, botY: nil, botDiameter: 44, agentMode: .column),
.result: ViewLayout(height: 160, botX: 52, botY: nil, botDiameter: 44, agentMode: .column),
.note: ViewLayout(height: 160, botX: 60, botY: nil, botDiameter: 50, agentMode: .column),
.settings: ViewLayout(height: 160, botX: 54, botY: nil, botDiameter: 46, agentMode: .none),
// Greeting: bot drawn by GreetingCanvasView; no BotPlacement needed
.greeting: ViewLayout(height: 150, botX: 320, botY: 90, botDiameter: 0, agentMode: .none),
.wardrobe: ViewLayout(height: 160, botX: 68, botY: nil, botDiameter: 58, agentMode: .none),
.recap: ViewLayout(height: 160, botX: 62, botY: nil, botDiameter: 58, agentMode: .column),
// Voice listening: Mochi (listening emote) on left, transcript on right
.listening: ViewLayout(height: 160, botX: 68, botY: nil, botDiameter: 58, agentMode: .none),
// Voice result: same layout as listening — Mochi on left, ✓/✗ on right
.voiceResult: ViewLayout(height: 160, botX: 68, botY: nil, botDiameter: 58, agentMode: .none),
// Screen capture: Mochi on the left (he just swallowed it), the image and what to do with it
.capture: ViewLayout(height: 160, botX: 58, botY: nil, botDiameter: 52, agentMode: .none),
// New version: Mochi on the left, the version and Update now
.update: ViewLayout(height: 160, botX: 62, botY: nil, botDiameter: 58, agentMode: .none),
// After an update: taller, four items then the stats (like mail, it fills the height)
.whatsNew: ViewLayout(height: 232, botX: 62, botY: nil, botDiameter: 58, agentMode: .none),
]
// Project colors — keyed by lowercase display name or slug
static let projectColors: [String: String] = [
"korus": "#FF5A4E",
"sbe hub": "#2EC4A0",
"morning ai brief": "#F29B38",
"publication ig": "#7C5CFF",
"ig post": "#7C5CFF",
"louisraille.fr": "#38BDF8",
"louisraille": "#38BDF8",
"notch buddy": "#EC4899",
"notch-buddy": "#EC4899",
"notchbuddy": "#EC4899",
]
static let fallbackColors = ["#22C55E", "#EAB308", "#60A5FA", "#E879F9"]
/// Returns the fixed project color for a display name, or a stable fallback.
static func colorForProject(_ name: String) -> String {
let key = name.lowercased().trimmingCharacters(in: .whitespaces)
if let c = projectColors[key] { return c }
// partial match (e.g. "korus-api" → "korus")
for (k, c) in projectColors where key.hasPrefix(k) || key.contains(k) { return c }
return fallbackColors[abs(name.hashValue) % fallbackColors.count]
}
// State card wash colors (radial gradient from bottom)
static let washColors: [IslandView: String] = [
.approval: "rgba(245,165,36,0.42)",
.question: "rgba(34,211,238,0.38)",
.error: "rgba(244,80,94,0.55)",
.finished: "rgba(52,211,153,0.5)",
.confused: "rgba(244,114,182,0.55)",
.searching: "rgba(99,102,241,0.5)",
.result: "rgba(52,211,153,0.22)",
.prompt: "rgba(99,102,241,0.22)",
]
}