Works with cmux
Available · Terminal host
cmux is a terminal workspace rather than a coding agent. Heard works with supported agents running inside it because the Claude Code and Codex integrations attach to the agent or its local session data, not to a specific terminal window.
Heard labels this integration as “Terminal host.” That label describes how Heard receives the work rather than treating every tool as if it had the same native connection.
- Current status
- Available
- Integration path
- Terminal host
- Desktop platform
- macOS 14 or later
- Talk back
- Heard PowerSupport depends on the underlying session path.
- Open source option
- Apache 2.0 for the open source engine
Setup
Set up Heard for cmux
-
Install Heard
Install and enable the Heard integration for the coding agent you use.
Open source engineheard install claude-code heard install codex-cli -
Connect cmux
Open that agent in a cmux workspace as usual.
-
Choose your listening mode
Use Heard to distinguish and follow the active sessions while cmux organizes the windows.
What you will hear
Narration is a filter, not a transcript
Heard looks for progress, blockers, decisions, failures, and useful results. Routine churn can stay quiet or become part of a later summary, depending on the listening mode you choose.
Claude Code and Codex sessions hosted in cmux
Several terminal workspaces followed as separate agent sessions
Spoken priority signals when one session needs attention
Co-pilot gives short signposts while the screen is on. Companion gives a fuller briefing away from the desk. Focus stays quiet until something needs you.
Limits
Know the boundary before you leave the screen
A reliable eyes off workflow starts with an accurate support boundary. Run a short test task, confirm that questions and final results reach Heard, and keep the original tool available for interactions the integration cannot route.
- cmux itself is not an event source or coding agent.
- Support depends on the agent running inside the terminal.
- Other command line tools need the open source engine’s
heard runwrapper.
Questions
Frequently asked questions
Does Heard work with cmux?
cmux is a terminal workspace rather than a coding agent. Heard works with supported agents running inside it because the Claude Code and Codex integrations attach to the agent or its local session data, not to a specific terminal window.
What kind of cmux support does Heard provide?
The current support level is terminal host. The page above names the exact setup path and limitations so “works with” does not hide the difference between a native adapter, a wrapper, and a terminal host.
Does Heard block cmux while it speaks?
No. Heard processes narration asynchronously. The coding agent can continue working while speech is generated and played.
Can I use Heard with several agents at once?
Yes. Heard keeps session context separate, gives attention to blockers and decisions, and can roll lower priority activity into a shorter spoken brief.
Can I talk back to the agent?
Talking back is part of Heard Power: say “Hey Parrot” or hold right ⌘ to dictate a reply, and pair your iPhone with the companion app to answer away from your desk. Availability can depend on the integration path and whether the underlying tool accepts the response through the active session.
What leaves my Mac?
The open source engine can use local Kokoro speech and your own keys. Managed narration can send a compact narration snippet to configured service providers. Heard does not retain source code, terminal output, narration text, or generated audio after a hosted request completes.
Ready when your agents are
Hear the work without watching every screen.
Start with the full Heard Power experience for 14 days. No card required. The open source engine remains free.
Download Heard for Mac macOS 14 or later · Claude Code and Codex supported