@domdhi/claude-code-tts 1.1.0 → 1.3.0

package/.claude/hooks/tts/daemon.py

@@ -3,7 +3,7 @@
 claude-code-tts — TTS daemon
 Persistent background process. Keeps model loaded. Serves speech via TCP.
 
-Protocol (JSON lines over localhost:6254):
+Protocol (JSON lines over localhost — port derived from install dir):
   {"cmd": "speak", "text": "...", "voice": "af_heart", "speed": 1.0, "project": "repo-name"}
   {"cmd": "stop"}
   {"cmd": "ping"}
@@ -30,8 +30,12 @@ os.environ.setdefault('OMP_NUM_THREADS', '6')
 os.environ.setdefault('ONNXRUNTIME_NUM_THREADS', '6')
 
 HOST = '127.0.0.1'
-PORT = 6254
 DAEMON_DIR = os.path.dirname(os.path.abspath(__file__))
+
+# Port is derived from install location — each install gets its own daemon port,
+# so multiple projects with local installs don't collide.
+import hashlib as _hashlib
+PORT = 49152 + (int(_hashlib.md5(DAEMON_DIR.encode()).hexdigest(), 16) % 16384)
 PID_FILE = os.path.join(DAEMON_DIR, 'daemon.pid')
 MODEL_PATH = os.path.join(DAEMON_DIR, 'models', 'kokoro-v1.0.onnx')
 VOICES_PATH = os.path.join(DAEMON_DIR, 'models', 'voices-v1.0.bin')

package/.claude/hooks/tts/repeat.py

@@ -20,7 +20,8 @@ VOICES_FILE = os.path.join(HOOK_DIR, 'voices.json')
 DAEMON_SCRIPT = os.path.join(HOOK_DIR, 'daemon.py')
 
 DAEMON_HOST = '127.0.0.1'
-DAEMON_PORT = 6254
+import hashlib as _hashlib
+DAEMON_PORT = 49152 + (int(_hashlib.md5(HOOK_DIR.encode()).hexdigest(), 16) % 16384)
 
 
 def _start_daemon():

package/.claude/hooks/tts/stop.py

@@ -21,7 +21,8 @@ VOICES_FILE = os.path.join(HOOK_DIR, 'voices.json')
 DAEMON_SCRIPT = os.path.join(HOOK_DIR, 'daemon.py')
 
 DAEMON_HOST = '127.0.0.1'
-DAEMON_PORT = 6254
+import hashlib as _hashlib
+DAEMON_PORT = 49152 + (int(_hashlib.md5(HOOK_DIR.encode()).hexdigest(), 16) % 16384)
 
 READ_ALL_CHAIN = False  # True = speak all assistant messages in chain, False = last only
 

package/.claude/hooks/tts/task-hook.py

@@ -19,7 +19,8 @@ VOICES_FILE = os.path.join(HOOK_DIR, 'voices.json')
 DAEMON_SCRIPT = os.path.join(HOOK_DIR, 'daemon.py')
 
 DAEMON_HOST = '127.0.0.1'
-DAEMON_PORT = 6254
+import hashlib as _hashlib
+DAEMON_PORT = 49152 + (int(_hashlib.md5(HOOK_DIR.encode()).hexdigest(), 16) % 16384)
 
 
 def strip_markdown(text):

package/INSTALL.md

@@ -43,8 +43,8 @@ The installer automatically:
 7. Patches `settings.json` / `settings.local.json` with hook entries (backs up original first)
 
 **Local vs global:**
-- Default (no flag): commands go to `./.claude/commands/voice/`, hooks registered in `./.claude/settings.local.json` (gitignored — safe to commit the project)
-- `--global`: commands go to `~/.claude/commands/voice/`, hooks registered in `~/.claude/settings.json`
+- Default (no flag): everything goes into `./.claude/` — hook scripts, commands, and `settings.local.json` (gitignored). Good for shipping TTS config alongside a project. Each install gets its own daemon port, so multiple local-installed projects run independently without conflict.
+- `--global`: everything goes into `~/.claude/` — hook scripts, commands, and `settings.json`. Recommended for personal use across all projects.
 
 ### Option B — installer script
 
@@ -290,7 +290,9 @@ Type in the Claude Code prompt:
 
 ## Daemon Protocol
 
-The daemon runs on `localhost:6254` and accepts JSON lines:
+The daemon runs on `localhost` on a port derived from the install directory (range 49152–65535). Each install location gets a stable, unique port — so multiple local-installed projects run independent daemons without conflict. Hook scripts and the daemon compute the same port, so they always find each other.
+
+Accepts JSON lines:
 
 | Command | Effect |
 |---------|--------|
@@ -347,8 +349,8 @@ The daemon auto-restarts on the next Claude response.
 - sounddevice doesn't always pull in cffi automatically
 
 ### Daemon keeps restarting / won't stay up
-- Check for port conflict: `lsof -i :6254` (Mac/Linux) or `netstat -ano | findstr 6254` (Windows)
-- Check `~/.claude/hooks/tts/daemon.log`
+- Each install uses a unique port derived from its directory path — port conflicts between installs are not possible
+- Check `daemon.log` in your hooks directory for errors
 
 ### Audio cuts off mid-sentence (kokoro fallback)
 - kokoro-onnx has a 510-token (~1500 char) hard limit

package/README.md

@@ -18,7 +18,7 @@ npx @domdhi/claude-code-tts
 npx @domdhi/claude-code-tts --global
 ```
 
-That's it. The installer copies the hook files, enables TTS, optionally installs the offline fallback, and automatically patches `settings.json` and installs the slash commands.
+That's it. The installer copies the hook files into `.claude/hooks/tts/`, enables TTS, optionally installs the offline fallback, installs slash commands, and patches `settings.local.json` — all in the current project directory. Use `--global` to install once for all projects.
 
 **Requirements:** Node.js 16+ and Python 3.10+ must both be installed. The hooks run in Python — Node is only used for the install command.
 

package/install.py

@@ -33,15 +33,16 @@ SOURCE_DIR = os.path.dirname(os.path.abspath(__file__))
 HOOKS_SOURCE    = os.path.join(SOURCE_DIR, '.claude', 'hooks', 'tts')
 COMMANDS_SOURCE = os.path.join(SOURCE_DIR, '.claude', 'commands', 'voice')
 
-INSTALL_DIR          = os.path.join(os.path.expanduser('~'), '.claude', 'hooks', 'tts')
-MODELS_DIR           = os.path.join(INSTALL_DIR, 'models')
+_home_claude = os.path.join(os.path.expanduser('~'), '.claude')
+_proj_claude = os.path.join(os.getcwd(), '.claude')
 
-# Default: project-local install (current directory's .claude/)
-# Overridden to ~/.claude/ when --global is passed
-_project_claude      = os.path.join(os.getcwd(), '.claude')
-COMMANDS_INSTALL_DIR = os.path.join(_project_claude, 'commands', 'voice')
-# Use settings.local.json for local scope — gitignored, machine-specific (absolute Python paths)
-SETTINGS_FILE        = os.path.join(_project_claude, 'settings.local.json')
+# Default: project-local — all files go into ./.claude/ (current project)
+# --global overrides all of these to ~/.claude/
+INSTALL_DIR          = os.path.join(_proj_claude, 'hooks', 'tts')
+MODELS_DIR           = os.path.join(INSTALL_DIR, 'models')
+COMMANDS_INSTALL_DIR = os.path.join(_proj_claude, 'commands', 'voice')
+# settings.local.json is gitignored — safe for machine-specific absolute paths
+SETTINGS_FILE        = os.path.join(_proj_claude, 'settings.local.json')
 
 GLOBAL_SCOPE = False
 
@@ -294,7 +295,7 @@ def main():
     parser = argparse.ArgumentParser(description='claude-code-tts installer')
     parser.add_argument(
         '--dir', metavar='PATH',
-        help='Install hooks to PATH instead of ~/.claude/hooks/tts/ (for testing)'
+        help='Override hook install directory (for testing only)'
     )
     parser.add_argument(
         '--global', dest='global_scope', action='store_true',
@@ -309,9 +310,10 @@ def main():
 
     if args.global_scope:
         GLOBAL_SCOPE = True
-        global_claude = os.path.join(os.path.expanduser('~'), '.claude')
-        COMMANDS_INSTALL_DIR = os.path.join(global_claude, 'commands', 'voice')
-        SETTINGS_FILE = os.path.join(global_claude, 'settings.json')
+        INSTALL_DIR          = os.path.join(_home_claude, 'hooks', 'tts')
+        MODELS_DIR           = os.path.join(INSTALL_DIR, 'models')
+        COMMANDS_INSTALL_DIR = os.path.join(_home_claude, 'commands', 'voice')
+        SETTINGS_FILE        = os.path.join(_home_claude, 'settings.json')
 
     scope_label = 'global (~/.claude/)' if args.global_scope else 'project-local (.claude/)'
     print(f'\nclaude-code-tts installer  [{scope_label}]\n')

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@domdhi/claude-code-tts",
-  "version": "1.1.0",
+  "version": "1.3.0",
   "description": "Neural TTS hook system for Claude Code. Reads Claude's responses aloud as they finish.",
   "bin": {
     "claude-code-tts": "bin/install.js"