Connect an agent

Other command line agents

Add Heard to a compatible terminal workflow with the universal wrapper.
View as Markdown

For a command line agent without a native Heard adapter, place heard run before the command you normally use. Heard starts the process, passes through its output, and turns useful terminal activity into narration.

Two ways to run Heard

Heard is one engine with two distributions. The downloadable macOS app is the official managed build: sign in and it works, with premium voices and managed narration on Pro and the full voice-input suite on Power. The open source engine (github.com/heardlabs/heard, Apache 2.0) is free forever: clone or fork it and run it yourself with a local voice or your own provider keys. Dictation, spoken replies, ambient input, Heard Parrot, and iPhone pairing exist only in the app.

Run a wrapped command

Terminal
$heard run <command> [args...]

For example:

Terminal
$heard run your-agent --project ./my-project

What to expect

  • The wrapper can only interpret information the terminal process exposes.
  • Full screen terminal interfaces may not provide enough structured output for reliable narration.
  • Questions or approvals may still require the original agent interface.
  • Native Claude Code and Codex adapters provide richer event context when available.

Verify compatibility

1

Wrap a short task

Start with a familiar command and a low risk task that produces visible terminal output.

2

Listen for a clear result

Confirm Heard speaks a useful summary instead of reading raw lines one by one.

3

Tune the listening mode

Use Co pilot for short signposts, Companion for fuller briefings, or Focus for important interruptions only.

Wrapper support varies by workflow. Test your command before relying on it while away from the screen.