claude-depester 1.4.0 → 1.5.0

package/README.md

@@ -4,17 +4,26 @@
 [![npm downloads](https://img.shields.io/npm/dm/claude-depester.svg)](https://www.npmjs.com/package/claude-depester)
 [![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
 
-Remove silly thinking words from Claude Code.
+Patches Claude Code CLI and VS Code extension to replace whimsical loading words with simple 'Thinking'.
 
 Instead of seeing "Flibbertigibbeting", "Discombobulating", "Clauding", etc., you'll see a clean "Thinking".
 
-> **Last updated:** 2026-02-10 | **Tested with:** Claude Code 2.1.4 - 2.1.38 | **Platforms:** Linux, macOS, Windows
+> **Last updated:** 2026-03-22 | **Tested with:** Claude Code 2.1.4 - 2.1.81 | **Platforms:** Linux, macOS, Windows
 >
-> v1.4.0: Fixed MachO binary bloat on macOS with Claude Code 2.1.37+ ([#5](https://github.com/ominiverdi/claude-depester/issues/5)). Added support for new Bun data format. Uses raw file write instead of LIEF write() for MachO/PE repacking.
+> 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:**
+
+![Thinking... instead of whimsical words](img/thinking.png)
+
+**CLI - Completion:**
 
-![Thinking... instead of silly words](img/thinking.png)
 ![Thought for Xs instead of Baked/Brewed/etc](img/thought.png)
 
+**VS Code Extension:**
+
+![VS Code extension also patched](img/vscode.png)
+
 ## The Problem
 
 Claude Code displays random silly words while thinking:
@@ -45,22 +54,33 @@ npx claude-depester --dry-run
 
 # Patch Claude Code
 npx claude-depester
+```
 
-# Auto-patch after updates (recommended)
-npx claude-depester --install-hook
+Restart Claude Code for changes to take effect.
+
+### Auto-patch after updates (recommended)
+
+Add a shell wrapper that patches before each invocation:
+
+```bash
+# Add to your .bashrc or .zshrc
+cl() { npx claude-depester --silent --log ; claude "$@" ; }
 ```
 
-That's it! Restart Claude Code for changes to take effect.
+Then use `cl` instead of `claude`. This ensures patching happens *before* Claude loads.
 
 ## Features
 
 - **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)
 - Auto-detects your Claude Code installation
 - Creates backup before patching (can restore anytime)
-- Optional SessionStart hook for auto-patching after updates
+- Shell wrapper for reliable auto-patching before Claude loads
 - Content-based detection survives version updates
 - Cross-platform: Linux, macOS, Windows (WSL/Git Bash)
 
@@ -68,13 +88,17 @@ That's it! Restart Claude Code for changes to take effect.
 
 | 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` |
 | `npx claude-depester --install-hook` | Auto-patch after updates |
 | `npx claude-depester --remove-hook` | Remove auto-patch hook |
 | `npx claude-depester --hook-status` | Check hook status |
@@ -89,6 +113,8 @@ That's it! Restart Claude Code for changes to take effect.
 | VS Code extension | `~/.vscode/extensions/anthropic.claude-code-*/` | Fully supported |
 | VS Code webview | `~/.vscode/extensions/.../webview/index.js` | Fully supported |
 | VSCodium extension | `~/.vscode-oss/extensions/anthropic.claude-code-*/` | Fully supported |
+| VS Code Remote (SSH) | `~/.vscode-server/extensions/anthropic.claude-code-*/` | Fully supported |
+| Cursor Remote (SSH) | `~/.cursor-server/extensions/anthropic.claude-code-*/` | Fully supported |
 | Local npm | `~/.claude/local/node_modules/@anthropic-ai/claude-code/` | Fully supported |
 | Global npm | `npm root -g`/@anthropic-ai/claude-code/ | Fully supported |
 
@@ -109,13 +135,13 @@ That's it! Restart Claude Code for changes to take effect.
 | 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.
+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.
 
-> **Important for VS Code users:** The extension has TWO places with spinner words - the native binary AND the webview. Use `--all` to patch both!
+> **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`.
 
 ## After Claude Code Updates
 
-With the hook installed (`--install-hook`), patching happens automatically on startup.
+If you're using the shell wrapper (recommended), patching happens automatically before each session.
 
 Otherwise, just run `npx claude-depester` again after updating.
 
@@ -127,7 +153,9 @@ npx claude-depester --restore
 
 This restores from the backup created during patching.
 
-## How the Hook Works
+## SessionStart Hook (Alternative)
+
+> **Note:** The shell wrapper is the recommended approach. The SessionStart hook has a limitation: it runs *after* Claude is already loaded into memory, so the patch only takes effect on the *next* session after an update.
 
 The `--install-hook` command adds a SessionStart hook to `~/.claude/settings.json`:
 
@@ -139,7 +167,7 @@ The `--install-hook` command adds a SessionStart hook to `~/.claude/settings.jso
         "hooks": [
           {
             "type": "command",
-            "command": "npx claude-depester --silent"
+            "command": "npx claude-depester --silent --log"
           }
         ]
       }
@@ -148,7 +176,12 @@ The `--install-hook` command adds a SessionStart hook to `~/.claude/settings.jso
 }
 ```
 
-Every time Claude Code starts, it checks and re-applies the patch if needed.
+This patches the file on disk at session start, but the current session may still show silly words until you restart. The `--log` flag writes results to `~/.claude/depester.log` (keeps last 50 entries) for troubleshooting.
+
+To install or update the hook:
+```bash
+npx claude-depester --install-hook
+> ```
 
 ## Troubleshooting
 
@@ -182,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).
@@ -191,14 +224,16 @@ Then **fully restart VS Code** (not just reload window).
 
 The detection uses content-based matching, so it should survive version updates.
 If the patch fails:
-1. Open an issue with your Claude Code version (`claude --version`)
-2. Include the output of `npx claude-depester --dry-run --verbose`
+1. Run `npx claude-depester --debug` to see detailed diagnostics
+2. Open an issue with your Claude Code version (`claude --version`)
+3. Include the output of `npx claude-depester --debug`
 
 ### Want to undo everything
 
 ```bash
-npx claude-depester --restore --all  # Restore all installations
-npx claude-depester --remove-hook    # Remove auto-patch hook
+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
 ```
 
 ## Technical Details
@@ -209,9 +244,11 @@ npx claude-depester --remove-hook    # Remove auto-patch hook
 
 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. Supports both old (pre-2.1.37) and new Bun data formats (different trailer signatures and module struct sizes)
 
@@ -219,6 +256,7 @@ npx claude-depester --remove-hook    # Remove auto-patch hook
 
 - **Backup**: `<original-file>.depester.backup`
 - **Hook config**: `~/.claude/settings.json`
+- **Debug log**: `~/.claude/depester.log` (when using `--log`)
 
 ## Requirements
 
@@ -260,6 +298,12 @@ This project builds upon work by:
 - [vemv's gist](https://gist.github.com/vemv/c6333d53ede16198a23eb95425051b7b) - Original simple patch idea
 - [heromantf's bun extractor](https://gist.github.com/heromantf/7db88edcb7b1c0c35067244584a01afc) - Bun binary structure documentation
 
+## Donors
+
+Thanks to these generous supporters:
+
+- [@gyohng](https://github.com/gyohng)
+
 ## License
 
 MIT - see [LICENSE](LICENSE)