Install agent-tts

Load the plugin for Claude Code, Cursor, or Antigravity, then enable speech once.

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

Keep it installed between sessions (recommended)

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

Same steps by hand:

claude plugin marketplace add ~/src/agent-tts --scope user
claude plugin install tts@tailrace -s user

That enables tts@tailrace for your user account. It survives closing Claude Code. After git pull of plugin changes: claude plugin update tts@tailrace.

In any new session:

/tts:tts on

This session only (until you quit)

claude --plugin-dir ~/src/agent-tts

--plugin-dir is temporary. TTS is available in that process only and is gone when you quit. Do not use it as the everyday install.

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

/tts in chat waits on the model. Use the tts binary for stop, skip, pause, and resume.

Confirm it works

Enable with tts on.
Ask the agent a short question.
When the turn completes, you should hear the lead paragraph (summary mode).
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. Cloud HTTPS certificate errors on python.org macOS are covered in Troubleshooting.