<!-- Generated from the same content as https://heard.dev/integrations/cmux. -->

# cmux voice updates for Claude Code and Codex | Heard

Source: https://heard.dev/integrations/cmux

Run supported coding agents inside cmux while Heard follows the agent integration on your Mac.

[](https://heard.dev/)[Open source](https://github.com/heardlabs/heard)

Available · Terminal host

# Give cmux a voice that knows what matters.

Run supported coding agents inside cmux while Heard follows the agent integration on your Mac.

[Download Heard for Mac](https://heard.dev/download) [Check compatibility](https://heard.dev/compatibility)

14 days of free Heard, no card required · macOS 14 or later

C

## 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 Power** Support depends on the underlying session path.

Open source option

**Apache 2.0 for the open source engine**

Setup

## Set up Heard for cmux

1.  ### Install Heard
    
    Install and enable the Heard integration for the coding agent you use.
    
    Open source engine
    
    ```
    heard install claude-code 
    heard install codex 
    ```
    
2.  ### Connect cmux
    
    Open that agent in a cmux workspace as usual.
    
3.  ### Finish setup
    
    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 speaks questions, approvals, blockers, failures and results. Routine tool steps stay quiet, so you hear what needs you. On Power, Catch me up gives a spoken recap of what your agents did.

Four agents running at once; press right ⌘ and Parrot jumps to the session you name.

1.  Claude Code and Codex sessions hosted in cmux
    
2.  Several terminal workspaces followed as separate agent sessions
    
3.  Spoken priority signals when one session needs attention
    

Mute updates when you want quiet; Parrot still answers when you ask.

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 run` wrapper.

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: press right ⌘ and tell Parrot what to send, and it goes to the session you name. 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.

Keep going

## Related Heard resources

[**Full compatibility matrix** Compare native adapters, wrappers, and terminal hosts.](https://heard.dev/compatibility) [**Manage several coding agents** Build an attention system for parallel agent work.](https://heard.dev/guides/manage-multiple-coding-agents) [**Privacy and data flow** See what stays local and what can leave your Mac.](https://heard.dev/security)

Ready when your agents are

## Hear the work without watching every screen.

Start with 14 days of free Heard: the full Power experience. No card required. The open source engine remains free.

[Download Heard for Mac](https://heard.dev/download) macOS 14 or later · Claude Code and Codex supported
