How yasirurf/coucou-watson works
Coucou is a cross-platform desktop companion for coding agents: agent hooks and optional service integrations feed live activity into a notch/top-edge island, where users can approve requests, inspect sessions, chat, and drop files. The macOS and Windows/Linux implementations have separate native and UI layers. The graph preserves documented chat, settings, character, and integration capabilities; several subsystem links are documented in the README because their implementation files were not sampled.
Main entry points: island.ts Island UI · AppState.swift App state · IslandWindowController.swift Island window · hooks.ts Hook handlers
Components 33
macOS app
- App state
NotchBuddy/Sources/App/AppState.swift - Island window
NotchBuddy/Sources/App/IslandWindowController.swift - Island views
NotchBuddy/Sources/App/IslandViewContent.swift - Agent pills
NotchBuddy/Sources/App/PillCatalog.swift - Agent hooks
NotchBuddy/Sources/App/HookServer.swift - Claude chat
NotchBuddy/Sources/App/ClaudeService.swift - File drop flow
NotchBuddy/Sources/App/UploadSequenceEngine.swift - Window context
NotchBuddy/Sources/App/WindowContextCapture.swift - Mochi character
NotchBuddy/Sources/App/BotEngine.swift - Sound engine
NotchBuddy/Sources/App/SoundEngine.swift
Windows/Linux UI
- UI bootstrap
windows/src/main.ts - Island UI
windows/src/island/island.ts - UI state
windows/src/core/state.ts - Island layout
windows/src/core/layout.ts - Island views
windows/src/views/views.ts - Mochi renderer
windows/src/mochi/engine.ts - Upload sequence
windows/src/upload/sequence.ts - Tauri bridge
windows/src/core/bridge.ts - Hook handlers
windows/src/island/hooks.ts - Integration handlers
windows/src/island/integrations.ts - DOM helpers
windows/src/views/dom.ts
Desktop services
- Island window
windows/src-tauri/src/island.rs - Hook service
windows/src-tauri/src/hooks.rs - Integration service
windows/src-tauri/src/integrations.rs - Claude service
windows/src-tauri/src/claude.rs - Settings storage
windows/src-tauri/src/settings.rs - Local logging
windows/src-tauri/src/log.rs
Companion features
- Settings
NotchBuddy/Sources/App/SettingsView.swift - Service pollers
NotchBuddy/Sources/App - Sound playback
windows/src/core/sound.ts
Other components
- User
- Coding agent
- External services
Connections 44
- Coding agent → Agent hooks: sends hooks
- Agent hooks → App state: updates activity
- App state → Island window: drives island
NotchBuddy/Sources/App/IslandWindowController.swift - Island window → Island views: hosts views
NotchBuddy/Sources/App/IslandWindowController.swift - Island window → File drop flow: starts upload
NotchBuddy/Sources/App/IslandWindowController.swift - Island window → Window context: captures context
NotchBuddy/Sources/App/IslandWindowController.swift - App state → Agent pills: uses catalog
NotchBuddy/Sources/App/AppState.swift - App state → Claude chat: uses chat service
NotchBuddy/Sources/App/AppState.swift - App state → Sound engine: controls sound
NotchBuddy/Sources/App/AppState.swift - User → Island window: interacts
- User → Claude chat: chats
- User → File drop flow: drops files
- User → Settings: configures
- Mochi character → Sound engine: plays effects
NotchBuddy/Sources/App/BotEngine.swift - Coding agent → Hook service: sends hooks
- Hook service → Hook handlers: emits events
- UI bootstrap → Island UI: launches
windows/src/main.ts - UI bootstrap → Hook handlers: registers handlers
windows/src/main.ts - UI bootstrap → Integration handlers: registers handlers
windows/src/main.ts - UI bootstrap → Tauri bridge: boots through
windows/src/main.ts - Island UI → UI state: reads state
windows/src/island/island.ts - Island UI → Island layout: uses geometry
windows/src/island/island.ts - Island UI → Island views: builds views
windows/src/island/island.ts - Island UI → Mochi renderer: renders character
windows/src/island/island.ts - Island UI → Upload sequence: runs sequence
windows/src/island/island.ts - Island UI → DOM helpers: creates elements
windows/src/island/island.ts - Hook handlers → Tauri bridge: uses bridge
windows/src/island/hooks.ts - Hook handlers → UI state: updates state
windows/src/island/hooks.ts - Island views → DOM helpers: builds elements
windows/src/views/views.ts - Integration handlers → Tauri bridge: uses bridge
- Integration handlers → UI state: reads state
- Mochi renderer → Sound playback: plays sounds
windows/src/mochi/engine.ts - Tauri bridge → Island window: invokes commands
windows/src/core/bridge.ts - Hook service → Settings storage: reads settings
windows/src-tauri/src/hooks.rs - Hook service → Local logging: logs events
windows/src-tauri/src/hooks.rs - Integration service → Claude service: uses Claude service
windows/src-tauri/src/integrations.rs - Integration service → Island window: updates island
windows/src-tauri/src/integrations.rs - Integration service → Local logging: logs events
windows/src-tauri/src/integrations.rs - External services → Integration service: provides updates
- Settings → App state: configures app
- User → Island UI: interacts
- User → Upload sequence: drops files
- User → Hook handlers: approves requests
- User → Settings storage: configures