Coucou Agent Companion
Keep coding-agent sessions and approval requests in view on your Mac, then follow them from your iPhone.
- Source repo
- Louis-CFM/coucou
- Stars
- ★ 7.4k
- Last updated
- 1d ago
- License
- MIT
- Primary language
- Swift
- FA score
- 67/100 · Some gaps
At a glance
- How it runs
- Works with
- Portable with changesCodex · Claude CodeOpenAI API · Claude API (Partial support)
- Cost
- Free software; you pay for model usage
- Setup effort
- Medium · a few setup steps
- You'll need
- Typical use
- A Claude Code user wants to watch session steps and file diffs and handle permission requests without switching away from current work.
- Not a fit if
- Users who need an iPhone App Store release
- Windows users who require a ready-to-run installer
- Website
- louis-cfm.github.io/coucou ↗ set on GitHub
- Maintenance
- Commits in the last 30 dayslast commit 2026-11-20latest release v0.6.1 (2026-11-19)+26.6 ★/day over 7 days
- Source review
- 67/100 · Some gaps
What does this agent do, and when should you use it?
Coucou is a desktop companion for developers, built with Swift 6, SwiftUI, and AppKit on macOS, with Tauri 2 versions for Windows and Linux. It receives session events through hooks and plugins for Claude Code, Codex, Cursor, Gemini CLI, and other tools, then shows activity, file changes, and pending requests at the top of the Mac screen. Users can approve or deny supported requests, answer questions, inspect diffs, and jump to the relevant terminal. A companion iPhone app syncs sessions, decisions, and instructions through the user's iCloud account, with Live Activities, notifications, and widgets. Coucou can also connect to user-configured AI providers and third-party services, with some features limited by platform.
On macOS, Coucou installs hooks for Claude Code and other tools; the nb-hook script forwards events to the app over a Unix socket, where it displays session steps, files read or changed, commands, and diffs. Claude Code permission requests offer Allow, Deny, or Always in the notch, and questions can be answered from their displayed choices; Codex supports Allow and Deny. Coucou can chat with Claude, Gemini, OpenAI, or local Ollama / LM Studio models, and poll configured integrations such as GitHub, Vercel, Stripe, n8n, Resend, Notion, and Cal.com. The iPhone app reads sessions from a private CloudKit database and writes back decisions, answers, and instructions; Live Activity updates use the stateless Cloudflare Worker in relay/.
- A Claude Code user wants to watch session steps and file diffs and handle permission requests without switching away from current work.
- A developer running Codex, Cursor, or several supported coding tools wants their sessions visible in one top-of-screen interface.
- Someone stepping away from a Mac wants to handle agent requests, answer questions, or send the next instruction from an iPhone.
- An independent developer wants to view coding sessions alongside status from GitHub, Vercel, or another supported service.
- A macOS developer wants to monitor coding sessions and chat using a local Ollama or LM Studio model.
How do you install or deploy this agent?
For macOS, download Coucou.zip from Releases, unzip it, move Coucou.app to /Applications, and launch it; or build from source with the commands below. The Windows installer is temporarily unavailable, so Windows users can package from source using the repository instructions. Linux has an x86_64 beta in AppImage, .deb, and .rpm formats; source builds require the listed system development packages. The iPhone app is currently available through a TestFlight beta; its App Store release is not yet available. Hooks and service credentials are configured as needed. The iPhone companion requires the same Apple Account on the Mac and phone.
How do you use this agent?
After launching, open Settings from the menu bar or system tray. To monitor Claude Code, choose Install hooks under Settings → Claude Code; install hooks or plugins from the relevant settings pages for Codex, Gemini CLI, Antigravity, and other supported tools. Start a supported agent session to see its events in Coucou; when an approval appears, choose Allow or Deny, or select an answer to a question. To pair an iPhone, enable session sharing under Settings → General → iPhone on the Mac, install the TestFlight beta on the phone, and allow notifications. For chat or service integrations, add the required API keys or credentials in their settings; keys are stored in the platform's credential store.
What are this agent's strengths and limitations?
- Puts session steps, file diffs, and approval requests at the top of the screen, reducing the need to switch to a terminal.
- Documents support for several coding tools and a --agent <name> hook path for other agents.
- The iPhone companion syncs through CloudKit and supports lock-screen approvals, notifications, Siri, and widgets.
- The macOS app is native and has no third-party dependencies; Tauri builds are also documented for Windows and Linux.
- The Windows installer is temporarily unavailable, and Linux releases are beta and currently x86_64 only.
- Several features are platform-limited; for example, Gemini/OpenAI/local-model chat and some plugins are macOS-only.
- The iPhone companion is still a TestFlight beta and requires iOS 18+, Mac-side setup, and the same iCloud account.
- Cloud-model chat and service integrations require user-supplied credentials; the README does not state every service's pricing.
How does this agent compare with similar options?
Key facts side by side with the most closely related agents.
| Agent | Source review | Form / cost | Stars | Updated | Language | Full support on |
|---|---|---|---|---|---|---|
| Coucou Agent Companion This agent | 67 · Some gaps | Desktop appFree + model costs | ★ 7.4k | 1d ago | Swift | Codex · Claude Code |
| Claude Code Skills & Plugins | 61 · Some gaps | Agent plugin / skillFree | ★ 30k | 1d ago | Python | Codex · Claude Code |
| Diri | 75 · Good | Desktop appFree + model costs | ★ 500 | 2d ago | Rust | Codex · Claude Code |
| EOC — Everything OpenAI Codex Workflow OS | 64 · Some gaps | Agent plugin / skillFree + model costs | ★ 77 | 5mo ago | JavaScript | Codex |
How does FollowAgents rate this agent?
Why each dimension lost points
CLAUDE.md directs secrets to OS credential stores, says there is no telemetry, and limits network calls to configured services. The README says approvals require explicit clicks, iPhone allows require Face ID, and Android phone linking is off by default with pairing and certificate pinning. The relay source allowlists push fields and caps request size; the Android relay describes forwarding encrypted frames. Deductions: these are mostly documentation or partial implementations; the packet does not show the complete permission set, key lifecycle, or all external calls, so data-flow and sensitive-data controls are supported but not exhaustive. Dependency-security evidence is limited.
The relay validates requests and defines timeouts and specific error responses; Android relay behavior tests describe shared expectations across two implementations, and the README lists version fixes. Deductions: the sampled code and README cannot independently substantiate the full set of product claims; there is little evidence about dependency availability, and the relay maps most APNs failures to 502, so failure handling is not comprehensive.
The README identifies audiences and scenarios across coding agents, Mac, iPhone, Android, Windows, and Linux, and states many platform and version boundaries. CLAUDE.md maps the platform source areas. Deductions: capability boundaries are mostly stated in prose, while triggers, permission behavior, and fallback paths are detailed only for some cases.
The README has feature sections, installation and phone guides, a version table, and stated limitations; the license is complete, and CLAUDE.md records release and maintenance conventions. Deductions: the README carries a very broad feature set, while the packet does not show a full FAQ, stable naming policy, or explicit maintenance response responsibility. Version history is detailed, but release-governance evidence is limited.
The product brings agent status, diffs, and approval actions into the desktop notch or phone notifications. The README describes direct approve, deny, answer, and terminal-jump workflows, giving the product a clear practical purpose. Deductions: these benefits are product claims in the supplied material, with no interaction or cost measurements; the broad integration scope also brings setup and maintenance costs.
The README gives concrete platform, feature, and version claims with some boundaries; the relay and Android relay sources support selected privacy and validation claims, and the test file contains behavioral assertions. Deductions: the packet samples only part of the source, so many safety and product claims cannot be cross-checked here; documentation claims must remain distinct from implementation evidence.
- The README lists many integrations and cross-platform capabilities, but this source sample covers only an entry point and portions of the relays; it cannot confirm implementation details for every feature.
- Some privacy, credential-storage, and user-confirmation assurances come from project documentation. Before adoption, inspect each platform's permission configuration, network calls, and credential-handling code.
- The relay returns a generic 502 for most APNs errors; the supplied material does not show how clients display or recover from those errors.
Recent releases
Latest entries from the project's GitHub Releases. Notes are quoted from upstream as written, not rewritten or tested by FollowAgents.
-
v0.6.1 Coucou 0.6.1
Release notes excerpt
Coucou 0.6.1 for macOS 15 or later (Apple silicon and Intel). Signed with a Developer ID and notarized by Apple. What's new - Mochi no longer weighs down 120 Hz Macs — on a ProMotion screen Mochi was redrawn 120 times a second, even folded in the notch: 35 to 60 % CPU, and as much again in WindowServer. He is now drawn at 60 fps while the island is open and 30 folded, the mini Mochis at 30, with the same motion on every screen; on a ProMotion Mac he also stops moving twice as fast (#1116, found by @liztim17) …View on GitHub ↗ -
android-v0.5.0 Coucou for Android 0.5.0
Release notes excerpt
Coucou for Android 0.5.0, by Rhytam Biswas (@Rhytam23): your coding agents on your Android phone. 1. Download Coucou-Android-0.5.0.apk on your phone (Android 11 or later) and open it. Android asks once to allow installs from your browser or file manager. 2. On your computer, Coucou 0.4.0 or later for Windows or Linux: Settings → Android phone, turn on Phone link, then Show pairing code. 3. Scan the code with the app. The phone and the computer must be on the same Wi-Fi. …View on GitHub ↗ -
v0.6.0 Coucou 0.6.0
Release notes excerpt
Coucou 0.6.0 for macOS 15 or later (Apple silicon and Intel). Signed with a Developer ID and notarized by Apple. What's new - Start a Claude Code session from the notch *(GitHub build)* — the terminal tab in the island's header, or ⌃⌥N: pick the project (the folders your sessions ran in, or any folder), type or dictate what Claude should do, and your terminal opens there with Claude Code and your words. Terminal, iTerm2, Ghostty, kitty, WezTerm and Alacritty; the prompt is never written into a command line …View on GitHub ↗
FAQ
Does Coucou require payment?
Does Coucou approve agent actions automatically?
Which systems and coding tools does it support?
Can I try Coucou without an API key or coding agent?
How does session data reach the iPhone?
Is Coucou Agent Companion free?
Is Coucou Agent Companion open source?
Is Coucou Agent Companion safe to use?
Is Coucou Agent Companion still maintained?
Who makes Coucou Agent Companion?
What is Coucou Agent Companion's official website?
Thanks — we use this to improve the page.