lystn 0.1.6

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 assistants

lystn install

Wires Lystn into Claude Code and, when local Codex is present, into the shared Codex config used by the Codex app, Codex CLI, and Codex IDE extension. Restart the assistant, or start a new session/thread, after installing. Every completed response will be spoken aloud.

To target only Codex local surfaces:

lystn install --codex

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	Wire Claude Code and detected Codex local surfaces

Requirements

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