How the4n6analyst/coucou works
Coucou is a cross-platform agent-session companion: desktop agents surface activity and requests in a Mochi island, users inspect or respond, and paired phone apps can receive session updates and approvals. The macOS app also adds Flow dictation and call notes, while desktop variants expose chat and integrations. The tree and README establish these major capabilities, but excerpts show only selected implementation links; dashed edges mark important documented or unverified relationships, and unsampled subsystems are represented at supported directory paths.
Main entry points: main.ts Windows Linux App · AppState.swift App State · HookServer.swift Agent Hooks · server.rs Phone Link Server
Components 25
Desktop Companion
- macOS App
NotchBuddy/Sources/App/NotchBuddyApp.swift - Windows Linux App
windows/src/main.ts - App State
NotchBuddy/Sources/App/AppState.swift - Settings
windows/src/settings/main.ts - Island UI
windows/src/island/island.ts - Desktop Bridge
windows/src/core/bridge.ts - UI State
windows/src/core/state.ts - Release Recap
windows/src/whats-new/controller.ts
Agent Sessions
- Agent Hooks
NotchBuddy/Sources/App/HookServer.swift - Windows Hooks
windows/hook/src/main.rs - Approvals Questions
NotchBuddy/Sources/App/ApprovalQueue.swift - Agent Chat
NotchBuddy/Sources/App/LocalChat.swift
Voice and Notes
- Flow Dictation
NotchBuddy/Sources/App/FlowDictation.swift - Offline Speech
NotchBuddy/Sources/App/ParakeetEngine.swift - Voice Assistant
NotchBuddy/Sources/App/Voice/VoiceEngine.swift - Call Notes
NotchBuddy/Sources/App/NoteTaker.swift
Phone Link
- Phone Apps
NotchBuddy/Sources/Phone/CoucouPhoneApp.swift - Phone Link Server
windows/src-tauri/src/phone_link/server.rs - Phone Link Hub
windows/src-tauri/src/phone_link/hub.rs - Android Link Client
android/app/src/main/kotlin/com/coucou/android/link/LinkClient.kt - Relay Service
relay/src/index.ts
Shared UI
- Mochi Engine
NotchBuddy/Sources/CoucouKit/BotEngine.swift - Pill Catalog
NotchBuddy/Sources/CoucouKit/PillCatalog.swift - Sound Engine
NotchBuddy/Sources/App/SoundEngine.swift
Other components
- User
Connections 25
- User → macOS App: uses
README.md - User → Windows Linux App: uses
README.md - User → Phone Apps: uses
README.md - macOS App → App State: coordinates
- Windows Linux App → Desktop Bridge: invokes
windows/src/core/bridge.ts - Windows Linux App → Island UI: renders
windows/src/main.ts - Windows Linux App → UI State: updates
windows/src/main.ts - Settings → Desktop Bridge: configures
windows/src/settings/main.ts - App State → Agent Hooks: starts
NotchBuddy/Sources/App/AppState.swift - Agent Hooks → Approvals Questions: routes requests
NotchBuddy/Sources/App/HookServer.swift - Agent Hooks → Island UI: surfaces events
- Windows Hooks → Windows Linux App: reports events
- App State → Agent Chat: selects provider
NotchBuddy/Sources/App/AppState.swift - Island UI → Mochi Engine: renders
- UI State → Mochi Engine: drives state
windows/src/core/state.ts - Pill Catalog → App State: defines pills
NotchBuddy/Sources/App/AppState.swift - Flow Dictation → Offline Speech: transcribes offline
- Voice Assistant → Flow Dictation: supports capture
- Call Notes → User: returns transcript
- Phone Link Server → Phone Link Hub: dispatches messages
windows/src-tauri/src/phone_link/server.rs - Phone Link Hub → Phone Apps: sends updates
- Android Link Client → Phone Link Server: connects
- Phone Link Server → Relay Service: uses relay
- Mochi Engine → Sound Engine: plays effects
NotchBuddy/Sources/CoucouKit/BotEngine.swift - Release Recap → Desktop Bridge: loads recap
windows/src/whats-new/controller.ts