lystn 0.1.0

Listen to AI coding assistant responses via Kokoro TTS.

lystn CLI

Cross-platform command-line client for the Lystn TTS server. Replaces the Windows-only PowerShell hook with a Python package that works on Windows, Mac, and Linux.

Install

pipx install -e .          # from this folder, while developing
# or once published:
pipx install lystn

pipx puts lystn on your PATH in an isolated environment — no conflicts with your other Python packages.

Configure

lystn config set server http://127.0.0.1:7878     # local server (default)
lystn config set voice af_heart                    # any voice from `lystn voices`
lystn config set api_key sk_...                    # only needed for cloud server later
lystn config show

Config lives at:

• Windows: %APPDATA%\lystn\config.json
• Mac/Linux: ~/.config/lystn/config.json

Use

lystn test                          # speak "Lystn is connected and working."
lystn speak "Hello there."          # speak the argument
echo "Hello there." | lystn speak   # speak stdin
lystn voices                        # list voices
lystn doctor                        # check server reachable

Wire into Claude Code

lystn install

Prints a JSON snippet — copy the hooks block into ~/.claude/settings.json. Restart Claude Code. Every completed response will be spoken aloud.

The hook is fire-and-forget: if the Lystn server is down or the text is empty, the hook exits silently and doesn't break Claude's UI.

Commands

Command	What it does
lystn speak [TEXT]	Speak text from argument or stdin
lystn hook	Claude Code Stop-hook entry — reads JSON from stdin
lystn test	Speak a short connection-test message
lystn voices	List voices the server offers
lystn doctor	Print config + server health
lystn config show	Show current config
lystn config set KEY VALUE	Update config (server, voice, api_key)
lystn install	Print the Claude Code settings snippet

Requirements

• Python 3.10+
• A running Lystn server (local Kokoro for now; cloud server later)
• Audio output device (sounddevice handles it cross-platform)