@domdhi/claude-code-tts 1.1.0 → 1.2.0

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. Note: the local daemon runs on `localhost:6254`; if you have two local-installed projects open at once, they'll share the port (the first one wins).
+- `--global`: everything goes into `~/.claude/` — hook scripts, commands, and `settings.json`. Recommended for personal use across all projects.
 
 ### Option B — installer script
 

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.2.0",
   "description": "Neural TTS hook system for Claude Code. Reads Claude's responses aloud as they finish.",
   "bin": {
     "claude-code-tts": "bin/install.js"