How bagpotato/coucou-ollama-windows-linux works
Coucou is a cross-platform companion for coding-agent sessions: the Mac/Windows app receives agent activity, presents status and approval/chat actions in a compact island, and can sync session and service information to an iPhone. The graph preserves the documented integrations, file-drop, and phone features alongside the main agent workflow. Several subsystems are represented by directory-level nodes because their implementations were not sampled; their links are limited to README-documented behavior or explicit source-index references.
Main entry points: main.ts Desktop entry · AppState.swift App state · IslandWindowController.swift Notch interface · PhoneLink.swift Phone link
Components 26
Mac companion
- Agent hooks
NotchBuddy/Sources/App/HookServer.swift - App state
NotchBuddy/Sources/App/AppState.swift - Notch interface
NotchBuddy/Sources/App/IslandWindowController.swift - Mochi character
NotchBuddy/Sources/CoucouKit/BotEngine.swift - AI chat
NotchBuddy/Sources/App/ClaudeService.swift - File drop flow
NotchBuddy/Sources/App/UploadSequenceEngine.swift - Service integrations
NotchBuddy/Sources/App - iCloud phone sync
NotchBuddy/Sources/App/PhoneLink/CloudProbe.swift
Windows and Linux
- Desktop entry
windows/src/main.ts - Island interface
windows/src/island/island.ts - UI state
windows/src/core/state.ts - Native bridge
windows/src/core/bridge.ts - Tauri backend
windows/src-tauri/src/lib.rs - Hook handling
windows/src-tauri/src/hooks.rs - Service integrations
windows/src-tauri/src/integrations.rs - Mochi engine
windows/src/mochi/engine.ts - Upload animation
windows/src/upload/sequence.ts
iPhone companion
- iPhone app
NotchBuddy/Sources/Phone/CoucouPhoneApp.swift - Phone link
NotchBuddy/Sources/Phone/PhoneLink.swift - Live activities
NotchBuddy/Sources/Phone/MochiLive.swift - Widgets
NotchBuddy/Sources/Widgets/CoucouWidgets.swift
Shared models
- Pill catalog
NotchBuddy/Sources/CoucouKit/PillCatalog.swift - Service snapshots
NotchBuddy/Sources/CoucouKit/ServiceSnapshot.swift
Other components
- User
- Coding agents
- Private CloudKit
Connections 29
- Coding agents → Agent hooks: send hook events
README.md - Agent hooks → App state: update session state
NotchBuddy/Sources/App/AppState.swift - App state → Notch interface: drive interface
NotchBuddy/Sources/App/IslandWindowController.swift - Notch interface → Mochi character: animate character
NotchBuddy/Sources/App/IslandWindowController.swift - User → Notch interface: inspect and act
README.md - Notch interface → AI chat: open chat
README.md - User → File drop flow: drop a file
README.md - App state → Service integrations: track service data
NotchBuddy/Sources/App/AppState.swift - Service integrations → Service snapshots: publish snapshots
NotchBuddy/Sources/App/PhoneLink/ServicePublisher.swift - App state → iCloud phone sync: publish session updates
NotchBuddy/Sources/App/PhoneLink/CloudProbe.swift - iCloud phone sync → Private CloudKit: sync privately
README.md - Private CloudKit → Phone link: sync phone data
README.md - iPhone app → Phone link: read sessions
- Phone link → Live activities: show live state
README.md - Phone link → Widgets: provide status
README.md - iPhone app → User: present alerts
README.md - Coding agents → Hook handling: send hook events
README.md - Desktop entry → Island interface: launch island
windows/src/main.ts - Desktop entry → UI state: load settings
windows/src/main.ts - Desktop entry → Native bridge: boot bridge
windows/src/main.ts - Desktop entry → Hook handling: register handlers
windows/src/main.ts - Desktop entry → Service integrations: register handlers
windows/src/main.ts - Native bridge → Tauri backend: invoke native commands
- Tauri backend → Hook handling: dispatch hook commands
windows/src-tauri/src/lib.rs - Tauri backend → Service integrations: dispatch integration commands
windows/src-tauri/src/lib.rs - Island interface → Mochi engine: render Mochi
windows/src/mochi/engine.ts - Island interface → Upload animation: run drop animation
windows/src/island/island.ts - App state → Pill catalog: use pill definitions
NotchBuddy/Sources/App/AppState.swift - Service snapshots → Pill catalog: reference service catalog
NotchBuddy/Sources/CoucouKit/ServiceSnapshot.swift