agent-tts
Reference

tts commands

Every subcommand on the shared CLI. Slash /tts and the tts binary call the same entry point.

tts <subcommand> [args...]

Config lives in ~/.agent-tts/config.json. Playback commands talk to the daemon over loopback TCP.

Enablement

CommandEffect
tts onEnable automatic speech after completed turns
tts offDisable, stop playback, clear the queue

Modes

CommandEffect
tts summaryFirst prose paragraph (default)
tts closingLast prose paragraph
tts briefFirst sentence of the lead paragraph
tts fullEntire cleaned response

See Choose what to speak.

Playback

CommandEffect
tts stopInterrupt current playback and clear queued jobs
tts skipSkip the current utterance group, continue this response
tts pauseHold this response after cutting the current group
tts resumeContinue a paused response
tts replay [mode]Replay the latest turn for this working directory
tts previewPrint the utterance queue without speaking

replay accepts summary, closing, brief, or full. Without an argument it uses the configured mode.

Voice and engine

CommandEffect
tts voice prose <name>Prose voice
tts voice header <name>Heading / blockquote voice
tts wpm <n>Rate in words per minute
tts voicesList voices for the active backend
tts backend <auto|macos|windows|linux|cloud>Speech engine
tts cloud provider <elevenlabs|openai|azure>Cloud vendor
tts cloud voice <id>Provider voice id
tts cloud key <api-key>Stored key (env var preferred)
tts cloud region <region>Azure region

Prefer ELEVENLABS_API_KEY, OPENAI_API_KEY, or AZURE_SPEECH_KEY over tts cloud key.

Status

CommandEffect
tts statusPrint enabled, mode, voices, backend, data dir
tts migrateCopy legacy ~/.claude/claude-code-tts into ~/.agent-tts

See also

On this page