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

# Ghostty voice updates for Claude Code and Codex | Heard

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

Use Heard with supported coding agents running in Ghostty without changing terminal apps.

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

Available · Terminal host

# Give Ghostty a voice that knows what matters.

Use Heard with supported coding agents running in Ghostty without changing terminal apps.

[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

G

## Works with Ghostty

Available · Terminal host

Ghostty is a terminal host. Heard follows native Claude Code or Codex integrations while those agents run inside Ghostty. For another command line agent, the open source engine’s `heard run` wrapper can work when its output is compatible.

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 Ghostty

1.  ### Install Heard
    
    Install Heard and enable Claude Code or Codex.
    
    Open source engine
    
    ```
    heard install claude-code 
    heard install codex 
    ```
    
2.  ### Connect Ghostty
    
    Run the agent in Ghostty normally.
    
3.  ### Finish setup
    
    Run a short task and check the first spoken update.
    

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.  Native Heard agent integrations hosted in Ghostty
    
2.  Several terminal sessions with distinct session context
    
3.  Generic command line workflows through the open source engine’s wrapper
    

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.

-   Ghostty is not itself a coding agent integration.
-   Generic process support depends on the universal wrapper and available output.
-   Heard is available on macOS today.

Questions

## Frequently asked questions

### Does Heard work with Ghostty?

Ghostty is a terminal host. Heard follows native Claude Code or Codex integrations while those agents run inside Ghostty. For another command line agent, the open source engine’s `heard run` wrapper can work when its output is compatible.

### What kind of Ghostty 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 Ghostty 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
