Install agent-tts

Speech starts disabled. You need:

• Python 3.9+
• A speech engine: say on macOS, SAPI on Windows, espeak-ng on Linux
• A clone of this repo

Claude Code

git clone https://github.com/TailraceHQ/agent-tts.git ~/src/agent-tts
claude --plugin-dir ~/src/agent-tts

In the session:

/tts on

To load it every time, wrap claude in your shell so --plugin-dir is always passed.

Cursor

git clone https://github.com/TailraceHQ/agent-tts.git ~/src/agent-tts
~/src/agent-tts/hosts/cursor/install.sh

install.sh writes the stop hook into ~/.cursor/hooks.json, installs /tts, and symlinks tts to ~/.local/bin/tts. Then:

tts on

Or /tts on in Agent chat.

Antigravity

git clone https://github.com/TailraceHQ/agent-tts.git ~/src/agent-tts
agy plugin install ~/src/agent-tts
~/src/agent-tts/hosts/antigravity/run cli on

Direct CLI

All hosts share ~/.agent-tts/ and the same CLI. After scripts/install-cli.sh:

tts status
tts closing
tts stop

Confirm it works

1. Enable with tts on.
2. Ask the agent a short question.
3. When the turn completes, you should hear the lead paragraph (summary mode).
4. Run tts preview to print the utterance queue without audio.

If nothing plays, check ~/.agent-tts/debug.log. TTS failures never block the agent turn.

See also

• Choose what to speak
• Control playback
• Command reference