How louis-cfm/coucou works
Coucou is a cross-platform notch/top-edge companion for Claude Code: session activity and approval events reach the island, where users can inspect work, approve or deny requests, chat, and handle files. The macOS implementation is native SwiftUI/AppKit; Windows pairs a Tauri/Rust backend with a TypeScript island. Both also display optional service integrations and animate Mochi. Some subsystem links below are documented in the README; unsampled implementation details are not inferred.
Main entry points: island.ts Island interaction and layout · lib.rs Tauri app commands · IslandWindowController.swift Island window and views · main.ts Frontend startup
Components 25
macOS app
- App lifecycle and state
NotchBuddy/Sources/App/AppState.swift - Island window and views
NotchBuddy/Sources/App/IslandWindowController.swift - Hook event server
NotchBuddy/Sources/App/HookServer.swift - Claude chat service
NotchBuddy/Sources/App/ClaudeService.swift - Integration polling
NotchBuddy/Sources/App - Mochi animation and sound
NotchBuddy/Sources/App/BotEngine.swift - File drop sequence
NotchBuddy/Sources/App/UploadSequenceEngine.swift - Window context capture
NotchBuddy/Sources/App/WindowContextCapture.swift
Windows island UI
- Frontend startup
windows/src/main.ts - Island interaction and layout
windows/src/island/island.ts - Island views
windows/src/views/views.ts - Mochi animation
windows/src/mochi/engine.ts - Upload sequence
windows/src/upload/sequence.ts - Frontend app state
windows/src/core/state.ts - Tauri bridge
windows/src/core/bridge.ts - Hook event handling
windows/src/island/hooks.ts - Integration event handling
windows/src/island/integrations.ts
Windows services
- Tauri app commands
windows/src-tauri/src/lib.rs - Named-pipe hook transport
windows/src-tauri/src/pipe.rs - Claude API service
windows/src-tauri/src/claude.rs - Integration polling
windows/src-tauri/src/integrations.rs - Settings and secrets
windows/src-tauri/src/settings.rs
Other components
- User
- Claude Code
- Connected services
Connections 28
- Claude Code → Hook event server: sends hook events
README.md - Hook event server → Island window and views: forwards events
README.md - User → Island window and views: interacts with
README.md - User → File drop sequence: drops files
README.md - User → Window context capture: attaches window
README.md - User → Claude chat service: asks questions
README.md - Connected services → Integration polling: provides updates
README.md - Island window and views → Mochi animation and sound: renders character
README.md - Island window and views → Integration polling: shows updates
README.md - User → Island interaction and layout: interacts with
README.md - Claude Code → Named-pipe hook transport: sends hook events
README.md - Named-pipe hook transport → Tauri app commands: relays events
windows/src-tauri/src/lib.rs - Frontend startup → Island interaction and layout: launches
windows/src/main.ts - Frontend startup → Hook event handling: registers handlers
windows/src/main.ts - Frontend startup → Integration event handling: registers handlers
windows/src/main.ts - Island interaction and layout → Island views: builds views
windows/src/island/island.ts - Island interaction and layout → Mochi animation: ticks animation
windows/src/island/island.ts - Island interaction and layout → Upload sequence: steps sequence
windows/src/island/island.ts - Island interaction and layout → Frontend app state: reads state
windows/src/island/island.ts - Tauri bridge → Tauri app commands: invokes commands
windows/src/core/bridge.ts - Hook event handling → Tauri bridge: uses bridge
windows/src/island/hooks.ts - Integration event handling → Tauri bridge: uses bridge
- Tauri app commands → Claude API service: dispatches commands
windows/src-tauri/src/lib.rs - Tauri app commands → Integration polling: dispatches commands
windows/src-tauri/src/lib.rs - Tauri app commands → Settings and secrets: loads settings
windows/src-tauri/src/lib.rs - Connected services → Integration polling: provides updates
README.md - User → Claude API service: chats with Claude
README.md - User → Upload sequence: drops files
README.md