claude-depester 1.3.6 → 1.5.0

package/README.md

@@ -8,9 +8,9 @@ Patches Claude Code CLI and VS Code extension to replace whimsical loading words
 
 Instead of seeing "Flibbertigibbeting", "Discombobulating", "Clauding", etc., you'll see a clean "Thinking".
 
-> **Last updated:** 2026-01-28 | **Tested with:** Claude Code 2.1.15 | **Platforms:** Linux, macOS, Windows
+> **Last updated:** 2026-03-22 | **Tested with:** Claude Code 2.1.4 - 2.1.81 | **Platforms:** Linux, macOS, Windows
 >
-> v1.3.6: Add support for VS Code Remote SSH and Cursor Remote SSH (`.vscode-server`, `.cursor-server`)
+> v1.5.0: New `--no-animation` flag disables the animated spinner icon in both CLI and VS Code. New `--no-tips` flag hides spinner tips. Fix for `--restore` crashing on locked files. Thanks [@noobydp](https://github.com/noobydp)!
 
 **CLI - Spinner:**
 
@@ -64,7 +64,7 @@ Add a shell wrapper that patches before each invocation:
 
 ```bash
 # Add to your .bashrc or .zshrc
-cl() { npx claude-depester --all --silent --log ; claude "$@" ; }
+cl() { npx claude-depester --silent --log ; claude "$@" ; }
 ```
 
 Then use `cl` instead of `claude`. This ensures patching happens *before* Claude loads.
@@ -73,6 +73,8 @@ Then use `cl` instead of `claude`. This ensures patching happens *before* Claude
 
 - **Patches spinner words** ("Flibbertigibbeting..." -> "Thinking...")
 - **Patches completion verbs** ("Baked for 42s" -> "Thought for 42s")
+- **Disables spinner animation** (`--no-animation`) - replaces cycling icon with a static dot
+- **Disables spinner tips** (`--no-tips`) - hides "Tip: ..." messages shown during thinking
 - Works with native binaries (Bun-compiled) and npm installations
 - **Patches VS Code/VSCodium extension webview** (the UI that shows spinner text)
 - **Supports remote development** (VS Code Remote SSH, Cursor SSH)
@@ -86,12 +88,14 @@ Then use `cl` instead of `claude`. This ensures patching happens *before* Claude
 
 | Command | Description |
 |---------|-------------|
-| `npx claude-depester` | Patch Claude Code |
-| `npx claude-depester --all` | Patch ALL installations (CLI + VS Code) |
-| `npx claude-depester --list` | List all found installations |
+| `npx claude-depester` | Patch all Claude Code installations |
+| `npx claude-depester --list` | List all found installations and status |
 | `npx claude-depester --dry-run` | Preview changes (no modifications) |
 | `npx claude-depester --check` | Check patch status |
-| `npx claude-depester --restore` | Restore original from backup |
+| `npx claude-depester --restore` | Restore all from backup |
+| `npx claude-depester --no-animation` | Disable animated spinner icon |
+| `npx claude-depester --no-tips` | Disable spinner tips |
+| `npx claude-depester --path <file>` | Target a specific file |
 | `npx claude-depester --verbose` | Show detailed info |
 | `npx claude-depester --debug` | Show detailed debug info (for troubleshooting) |
 | `npx claude-depester --log` | Write results to `~/.claude/depester.log` |
@@ -131,9 +135,7 @@ Then use `cl` instead of `claude`. This ensures patching happens *before* Claude
 | VS Code extension | `%USERPROFILE%\.vscode\extensions\anthropic.claude-code-*\` | Fully supported |
 | VS Code webview | `...\extensions\...\webview\index.js` | Fully supported |
 
-The tool auto-detects your installation. Use `--list` to see all found installations, and `--all` to patch them all at once.
-
-> **Important for VS Code users:** The extension has TWO places with spinner words - the native binary AND the webview. Use `--all` to patch both!
+The tool auto-detects all your installations. Use `--list` to see them. All commands (patch, check, restore) operate on all installations by default. Use `--path <file>` to target a specific file.
 
 > **Remote Development (SSH):** When using VS Code Remote or Cursor over SSH, run the tool **on the remote server** to patch `~/.vscode-server` or `~/.cursor-server`.
 
@@ -165,7 +167,7 @@ The `--install-hook` command adds a SessionStart hook to `~/.claude/settings.jso
         "hooks": [
           {
             "type": "command",
-            "command": "npx claude-depester --all --silent --log"
+            "command": "npx claude-depester --silent --log"
           }
         ]
       }
@@ -213,7 +215,7 @@ The VS Code extension has **TWO separate components** with spinner words:
 You must patch BOTH for the fix to work. Use:
 ```bash
 npx claude-depester --list    # Should show both binary AND webview
-npx claude-depester --all     # Patch ALL components
+npx claude-depester           # Patches all components
 ```
 
 Then **fully restart VS Code** (not just reload window).
@@ -229,7 +231,7 @@ If the patch fails:
 ### Want to undo everything
 
 ```bash
-npx claude-depester --restore --all  # Restore all installations
+npx claude-depester --restore        # Restore all installations
 npx claude-depester --remove-hook    # Remove hook (if installed)
 # Remove the shell wrapper from your .bashrc/.zshrc if added
 ```
@@ -242,11 +244,13 @@ npx claude-depester --remove-hook    # Remove hook (if installed)
 
 2. **Extraction**: For native binaries (Bun-compiled), uses [node-lief](https://www.npmjs.com/package/node-lief) to properly extract the embedded JavaScript - the same approach used by [tweakcc](https://github.com/Piebald-AI/tweakcc)
 
-3. **Patching**: Replaces two arrays:
+3. **Patching**: Replaces arrays and settings:
    - Spinner words: `["Accomplishing",...,"Zigzagging"]` -> `["Thinking"]`
    - Completion verbs: `["Baked",...,"Worked"]` -> `["Thought"]`
+   - Spinner icon animation (`--no-animation`): `["·","✢","*","✶","✻","✽"]` -> `["·"]`
+   - Spinner tips (`--no-tips`): sets `spinnerTipsEnabled: false` in Claude settings
 
-4. **Repacking**: Rebuilds the binary with the modified JavaScript
+4. **Repacking**: Rebuilds the binary with the modified JavaScript. Supports both old (pre-2.1.37) and new Bun data formats (different trailer signatures and module struct sizes)
 
 ### File locations
 
@@ -263,14 +267,14 @@ npx claude-depester --remove-hook    # Remove hook (if installed)
 
 | Platform | Binary Patching | Webview Patching | Status |
 |----------|-----------------|------------------|--------|
-| Linux x64 | ELF | Yes | Tested |
+| Linux x64 | ELF | Yes | Tested (2.1.27) |
 | Linux ARM64 | ELF | Yes | Should work |
 | macOS Intel | MachO | Yes | Should work |
-| macOS Apple Silicon | MachO | Yes | Should work |
+| macOS Apple Silicon | MachO | Yes | Tested (2.1.38) |
 | Windows x64 | PE | Yes | Should work |
 | Windows ARM64 | PE | Yes | Should work |
 
-The tool uses [node-lief](https://www.npmjs.com/package/node-lief) which has prebuilt binaries for all these platforms.
+Binary repacking uses raw file writes (byte-level section replacement) for MachO and PE formats, avoiding LIEF write() which could produce bloated output. ELF uses LIEF write(). The tool uses [node-lief](https://www.npmjs.com/package/node-lief) for binary parsing on all platforms.
 
 ## Contributing