lystn 0.2.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 https://api.lystn.space    # cloud server (default)
lystn config set voice af_heart                    # any voice from `lystn voices`
lystn config set speed 1.25                         # playback rate 0.5–3.0
lystn config show

The default server is https://api.lystn.space. For local dev, point it at your own box, e.g. lystn config set server http://127.0.0.1:7878. Sign in with lystn login (browser Google sign-in saves your key automatically) — you rarely set api_key by hand.

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's Stop hook 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. It also adds a branded animated statusLine to Claude Code — non-destructively, so your own custom status line is never replaced. Restart the assistant, or start a new session/thread, after installing. Every completed response will be spoken aloud. lystn uninstall removes only Lystn's entries (its hook and its status line).

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	Stop-hook entry (Claude Code / Codex) — reads JSON from stdin
lystn test	Speak a short connection-test message
lystn login / lystn logout	Browser Google sign-in / clear saved key
lystn voices	List voices the server offers
lystn doctor	Print config + server health
lystn devices [--pick]	List audio outputs; --pick saves one
lystn mute / lystn unmute	Silence Lystn / turn it back on
lystn speed [0.5-3.0]	Set/show playback speed
lystn volume [0-100]	Set/show volume
lystn statusline	Print the branded animated status line
lystn config show	Show current config
lystn config set KEY VALUE	Update config (server, api_key, voice, device, speed)
lystn install / lystn uninstall	Wire/unwire Claude Code + detected Codex

Requirements

• Python 3.10+
• A reachable Lystn server (defaults to the cloud https://api.lystn.space; point at a local Kokoro server for dev)
• Audio output device (sounddevice handles it cross-platform)