Claude Code

aiTTS and Claude Code

aiTTS has two pieces that both talk to Claude Code. The aiTTS Mac app narrates a running Claude Code session automatically, in the background, the moment you attach it. The /tts skill below is a separate, smaller tool: a one-off command that reads one thing aloud and exits. It does not run a background narrator itself, it talks to the app that does.

Install the /tts skill

Two commands, from any terminal:

Install in Claude Code

Two commands. Done.

The fastest install. Adds the marketplace, installs the plugin, and you can run /tts in any Claude Code session. The plugin drives the aiTTS app, so install the app first.

~/your-project
$claude plugin marketplace add wickdninja/aitts-plugin
$claude plugin install tts@aitts

Prefer a DMG? Download the macOS app.

Use it

/tts is a one-off tool. It reads one thing aloud, right now, and exits, it does not attach or keep running.

/ttsread the last reply aloud
/tts ./README.mdread a file or URL aloud
read this to meor just ask in plain English

The skill has no synthesis of its own, it forwards to the app. Voice, speed, and engine (Kokoro or Gemini) are chosen once in the app's Settings > Voice, not as flags here.

Continuous narration is the Mac app, not the skill

Narrating every response as Claude Code streams it, captions, the lock-screen Now Playing card, dictation: that is all the menu bar app, not the plugin. If you only install the skill you get one-off reads; grab the app from the download page for continuous narration, then a running Claude Code session attaches on its own.

Other agents

aiTTS also narrates Codex CLI, Gemini CLI, OpenCode, Aider, Cline, and pi sessions. Those don't have a one-command plugin install today; open the app's Settings > Agents pane, which gives you the exact attach command for the agent you're running.

Uninstall

claude plugin uninstall tts@aitts
claude plugin marketplace remove aitts