feat(desktop): play completion sound on Linux

[karacsonybarni]

Why

On Ubuntu, an agent can finish while T3 Code is in the background without an audible cue. This adds a lightweight Codex CLI-like completion sound using the platform beep, while leaving web, mobile, and non-Linux desktop behavior unchanged.

What Changed

• Observe completed agent turns in the desktop renderer without replaying sounds for initial hydration or repeated state updates.
• Route completion notifications through the typed preload/IPC bridge and play Electron's native system beep on Linux only.
• Document the Linux desktop behavior and cover completion tracking, platform gating, and the Electron shell call with focused tests.

Checklist

• This PR is small and focused
• I explained what changed and why
• Screenshots are not applicable because there is no visual UI change
• Video is not applicable because there is no visual animation or interaction change

Built with GPT-5 using Codex.

Note

Play system beep on Linux when an agent turn completes

• Adds a DesktopTurnCompletionSound React component mounted globally in __root.tsx that watches thread snapshots and calls playTurnCompletionSound via window.desktopBridge once per newly completed turn.
• Adds a createTurnCompletionTracker utility that detects transitions to completed state, ignoring turns already completed on first observation and deduplicating repeat syncs.
• Adds a new desktop:play-turn-completion-sound IPC channel handled in window.ts; on Linux it calls ElectronShell.beep(), on other platforms it is a no-op.
• Exposes ElectronShell.beep as an Effect wrapping Electron.shell.beep() and adds playTurnCompletionSound to the DesktopBridge interface as an optional method.

^{Macroscope summarized b93fd06.}

---

Note

Low Risk
User-facing audio on Linux only, gated in main and renderer; no auth, data, or orchestration changes.

Overview
Adds an audible cue when agent turns finish on Linux desktop, using the platform system beep so background sessions are noticeable without changing web, mobile, or macOS/Windows behavior.

The web shell mounts DesktopTurnCompletionSound in the root layout. It watches thread shells via createTurnCompletionTracker, which only counts turns that transition to completed after the first sync—skipping hydration, repeated updates, interrupted/error turns, and threads that appear already completed.

Completion triggers window.desktopBridge.playTurnCompletionSound() through a new IPC channel; the main process calls Electron.shell.beep() only when DesktopEnvironment.platform === "linux". ElectronShell gains a beep effect; DesktopBridge documents optional playTurnCompletionSound. Install docs note Linux beep behavior; tests cover tracker logic, platform gating, and shell beep.

^{Reviewed by Cursor Bugbot for commit b93fd06. Bugbot is set up for automated code reviews on this repo. Configure here.}

[coderabbitai]

Important

Review skipped

Auto reviews are disabled on this repository. Please check the settings in the CodeRabbit UI or the .coderabbit.yaml file in this repository. To trigger a single review, invoke the @coderabbitai review command.

⚙️ Run configuration

Configuration used: Repository UI

Review profile: CHILL

Plan: Pro Plus

Run ID: a84534ff-f3e2-4de7-bdd3-3a7d306320d0

You can disable this status message by setting the reviews.review_status to false in the CodeRabbit configuration file.

Use the checkbox below for a quick retry:

• 🔍 Trigger review

---

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

• X
• Mastodon
• Reddit
• LinkedIn

_{Comment @coderabbitai help to get the list of available commands.}

[cursor]

Cursor Bugbot has reviewed your changes using high effort and found 1 potential issue.

^{❌ Bugbot Autofix is OFF. To automatically fix reported issues with cloud agents, enable autofix in the Cursor dashboard.}

Want fixes drafted automatically? Bugbot Autofix can create code changes for findings. A team admin can enable Autofix in the Cursor dashboard.

^{Reviewed by Cursor Bugbot for commit d2df20a. Configure here.}

[macroscopeapp]

Approvability

Verdict: Needs human review

This PR introduces a new user-facing feature (completion sound notifications on Linux) with new components, IPC channels, and state tracking logic. New features introducing user-facing behavior warrant human review even when well-scoped.

^{You can customize Macroscope's approvability policy. Learn more.}