> For clean Markdown of any page, append .md to the page URL.
> For a complete documentation index, see https://docs.heard.dev/llms.txt.
> For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://docs.heard.dev/_mcp/server.

# Other command line agents

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](https://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

```bash title="Terminal"
heard run <command> [args...]
```

For example:

```bash title="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

#### Wrap a short task

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

#### Listen for a clear result

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

#### 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.