claude-depester 1.0.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 ominiverdi
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,191 @@
+# claude-depester
+
+[![npm version](https://img.shields.io/npm/v/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.
+
+Instead of seeing "Flibbertigibbeting", "Discombobulating", "Clauding", etc., you'll see a clean "Thinking".
+
+> **Last updated:** 2026-01-11 | **Tested with:** Claude Code 2.1.4
+
+![Thinking... instead of silly words](img/screenshot1.png)
+
+## The Problem
+
+Claude Code displays random silly words while thinking:
+
+```
+Flibbertigibbeting...
+Discombobulating...
+Smooshing...
+Wibbling...
+Clauding...
+```
+
+This tool replaces them with a simple "Thinking".
+
+## Quick Start
+
+```bash
+# Preview changes first (recommended)
+npx claude-depester --dry-run
+
+# Patch Claude Code
+npx claude-depester
+
+# Auto-patch after updates (recommended)
+npx claude-depester --install-hook
+```
+
+That's it! Restart Claude Code for changes to take effect.
+
+## Features
+
+- Works with native binaries (Bun-compiled) and npm installations
+- Auto-detects your Claude Code installation
+- Creates backup before patching (can restore anytime)
+- Optional SessionStart hook for auto-patching after updates
+- Content-based detection survives version updates
+
+## Commands
+
+| Command | Description |
+|---------|-------------|
+| `npx claude-depester` | Patch Claude Code |
+| `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 --verbose` | Show detailed info |
+| `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 |
+| `npx claude-depester --help` | Show help |
+
+## Supported Installation Methods
+
+| Method | Path | Status |
+|--------|------|--------|
+| Native binary | `~/.local/bin/claude` -> `~/.local/share/claude/versions/X.Y.Z` | 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 |
+| Homebrew | `/opt/homebrew/Caskroom/claude-code/` | Fully supported |
+
+The tool auto-detects your installation.
+
+## After Claude Code Updates
+
+With the hook installed (`--install-hook`), patching happens automatically on startup.
+
+Otherwise, just run `npx claude-depester` again after updating.
+
+## Restore Original
+
+```bash
+npx claude-depester --restore
+```
+
+This restores from the backup created during patching.
+
+## How the Hook Works
+
+The `--install-hook` command adds a SessionStart hook to `~/.claude/settings.json`:
+
+```json
+{
+  "hooks": {
+    "SessionStart": [
+      {
+        "hooks": [
+          {
+            "type": "command",
+            "command": "npx claude-depester --silent"
+          }
+        ]
+      }
+    ]
+  }
+}
+```
+
+Every time Claude Code starts, it checks and re-applies the patch if needed.
+
+## Troubleshooting
+
+### "Could not find Claude Code installation"
+
+Make sure Claude Code is installed:
+- Check with `claude --version`
+- Run with `--verbose` to see searched paths
+
+### Patch not working after update
+
+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`
+
+### Want to undo everything
+
+```bash
+npx claude-depester --restore      # Restore original file
+npx claude-depester --remove-hook  # Remove auto-patch hook
+```
+
+## Technical Details
+
+### How it works
+
+1. **Detection**: Finds the silly words array by unique content markers (e.g., "Flibbertigibbeting", "Discombobulating") rather than variable names (which change every version due to minification)
+
+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 the array `["Accomplishing",...,"Zigzagging"]` with `["Thinking"]`
+
+4. **Repacking**: Rebuilds the binary with the modified JavaScript
+
+### File locations
+
+- **Backup**: `<original-file>.depester.backup`
+- **Hook config**: `~/.claude/settings.json`
+
+## Requirements
+
+- Node.js >= 18.0.0
+- Claude Code installed
+
+## Contributing
+
+If Claude Code updates and the patch stops working:
+
+1. Check if the array still contains marker words like `"Flibbertigibbeting"`
+2. Update `lib/patcher.js` if the pattern changed
+3. Submit a PR
+
+Issues and PRs welcome!
+
+## Related Projects
+
+- [tweakcc](https://github.com/Piebald-AI/tweakcc) - Full Claude Code customization (themes, prompts, and more)
+- [claude-code-thinking-patch](https://github.com/aleks-apostle/claude-code-thinking-patch) - Thinking visibility patch
+
+## Acknowledgments
+
+This project builds upon work by:
+- [tweakcc](https://github.com/Piebald-AI/tweakcc) - For the proper Bun binary extraction/repacking approach
+- [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
+
+## License
+
+MIT - see [LICENSE](LICENSE)
+
+---
+
+## Appendix: Full List of Silly Words
+
+These are all 184 "thinking words" that Claude Code displays while processing. This tool replaces all of them with "Thinking":
+
+> Accomplishing, Actioning, Actualizing, Architecting, Baking, Beaming, Beboppin', Befuddling, Billowing, Blanching, Bloviating, Boogieing, Boondoggling, Booping, Bootstrapping, Brewing, Burrowing, Calculating, Canoodling, Caramelizing, Cascading, Catapulting, Cerebrating, Channeling, Channelling, Choreographing, Churning, Clauding, Coalescing, Cogitating, Combobulating, Composing, Computing, Concocting, Considering, Contemplating, Cooking, Crafting, Creating, Crunching, Crystallizing, Cultivating, Deciphering, Deliberating, Determining, Dilly-dallying, Discombobulating, Doing, Doodling, Drizzling, Ebbing, Effecting, Elucidating, Embellishing, Enchanting, Envisioning, Evaporating, Fermenting, Fiddle-faddling, Finagling, Flambeing, Flibbertigibbeting, Flowing, Flummoxing, Fluttering, Forging, Forming, Frolicking, Frosting, Gallivanting, Galloping, Garnishing, Generating, Germinating, Gitifying, Grooving, Gusting, Harmonizing, Hashing, Hatching, Herding, Honking, Hullaballooing, Hyperspacing, Ideating, Imagining, Improvising, Incubating, Inferring, Infusing, Ionizing, Jitterbugging, Julienning, Kneading, Leavening, Levitating, Lollygagging, Manifesting, Marinating, Meandering, Metamorphosing, Misting, Moonwalking, Moseying, Mulling, Mustering, Musing, Nebulizing, Nesting, Noodling, Nucleating, Orbiting, Orchestrating, Osmosing, Perambulating, Percolating, Perusing, Philosophising, Photosynthesizing, Pollinating, Pondering, Pontificating, Pouncing, Precipitating, Prestidigitating, Processing, Proofing, Propagating, Puttering, Puzzling, Quantumizing, Razzle-dazzling, Razzmatazzing, Recombobulating, Reticulating, Roosting, Ruminating, Sauteing, Scampering, Schlepping, Scurrying, Seasoning, Shenaniganing, Shimmying, Simmering, Skedaddling, Sketching, Slithering, Smooshing, Sock-hopping, Spelunking, Spinning, Sprouting, Stewing, Sublimating, Swirling, Swooping, Symbioting, Synthesizing, Tempering, Thinking, Thundering, Tinkering, Tomfoolering, Topsy-turvying, Transfiguring, Transmuting, Twisting, Undulating, Unfurling, Unravelling, Vibing, Waddling, Wandering, Warping, Whatchamacalliting, Whirlpooling, Whirring, Whisking, Wibbling, Working, Wrangling, Zesting, Zigzagging
+
+<sub>**Keywords:** claude code thinking words, claude code spinner, claude code flibbertigibbeting, claude code discombobulating, claude code clauding, claude code smooshing, claude code wibbling, anthropic claude code patch, remove silly words claude, claude code customization</sub>

package/bin/claude-depester

@@ -0,0 +1,215 @@
+#!/usr/bin/env node
+
+/**
+ * claude-depester CLI
+ * Remove silly thinking words from Claude Code
+ */
+
+const { findCliJs, getSearchedPaths } = require('../lib/detector');
+const { patch, checkStatus, restoreBackup } = require('../lib/patcher');
+const { installHook, removeHook, getHookStatus } = require('../lib/hooks');
+
+const VERSION = require('../package.json').version;
+
+// Parse arguments
+const args = process.argv.slice(2);
+const flags = {
+  help: args.includes('--help') || args.includes('-h'),
+  version: args.includes('--version') || args.includes('-v'),
+  check: args.includes('--check') || args.includes('-c'),
+  restore: args.includes('--restore') || args.includes('-r'),
+  dryRun: args.includes('--dry-run') || args.includes('-n'),
+  installHook: args.includes('--install-hook'),
+  removeHook: args.includes('--remove-hook'),
+  hookStatus: args.includes('--hook-status'),
+  silent: args.includes('--silent') || args.includes('-s'),
+  verbose: args.includes('--verbose')
+};
+
+function log(...msg) {
+  if (!flags.silent) {
+    console.log(...msg);
+  }
+}
+
+function error(...msg) {
+  console.error(...msg);
+}
+
+function showHelp() {
+  console.log(`
+claude-depester v${VERSION}
+
+Remove silly thinking words from Claude Code (like "Flibbertigibbeting", 
+"Discombobulating", etc.) and replace them with "Thinking".
+
+USAGE:
+  npx claude-depester [options]
+
+OPTIONS:
+  (no options)      Patch Claude Code now
+  -c, --check       Check if Claude Code is patched
+  -r, --restore     Restore original file from backup
+  -n, --dry-run     Preview changes without applying
+  
+  --install-hook    Add SessionStart hook (auto-patch after updates)
+  --remove-hook     Remove SessionStart hook
+  --hook-status     Check if hook is installed
+  
+  -s, --silent      Suppress output (for hook use)
+  --verbose         Show detailed information
+  -v, --version     Show version
+  -h, --help        Show this help
+
+EXAMPLES:
+  npx claude-depester                 # Patch now
+  npx claude-depester --check         # Check status
+  npx claude-depester --install-hook  # Auto-patch after updates
+  npx claude-depester --restore       # Undo patch
+
+MORE INFO:
+  https://github.com/ominiverdi/claude-depester
+`);
+}
+
+function showVersion() {
+  console.log(`claude-depester v${VERSION}`);
+}
+
+function showSearchedPaths() {
+  error('\nSearched paths:');
+  for (const { method, path } of getSearchedPaths()) {
+    error(`  [${method}]`);
+    error(`    ${path}`);
+  }
+}
+
+async function main() {
+  // Handle help/version first
+  if (flags.help) {
+    showHelp();
+    process.exit(0);
+  }
+  
+  if (flags.version) {
+    showVersion();
+    process.exit(0);
+  }
+  
+  // Handle hook management (doesn't require finding cli.js)
+  if (flags.hookStatus) {
+    const status = getHookStatus();
+    log(`Hook installed: ${status.installed ? 'yes' : 'no'}`);
+    log(`Settings file: ${status.settingsPath}`);
+    process.exit(0);
+  }
+  
+  if (flags.installHook) {
+    const result = installHook();
+    log(result.message);
+    process.exit(result.success ? 0 : 1);
+  }
+  
+  if (flags.removeHook) {
+    const result = removeHook();
+    log(result.message);
+    process.exit(result.success ? 0 : 1);
+  }
+  
+  // Find Claude Code installation
+  const cliInfo = findCliJs();
+  
+  if (!cliInfo) {
+    error('Could not find Claude Code installation.');
+    if (flags.verbose) {
+      showSearchedPaths();
+    } else {
+      error('Run with --verbose to see searched paths.');
+    }
+    error('\nMake sure Claude Code is installed:');
+    error('  https://code.claude.com/docs/en/setup');
+    process.exit(1);
+  }
+  
+  if (flags.verbose) {
+    log(`Found Claude Code: ${cliInfo.path}`);
+    log(`Detection method: ${cliInfo.method}`);
+  }
+  
+  // Handle check
+  if (flags.check) {
+    const status = checkStatus(cliInfo.path);
+    
+    if (status.error) {
+      error(`Error: ${status.error}`);
+      process.exit(1);
+    }
+    
+    if (status.patched) {
+      log('Status: PATCHED');
+      log('Silly words have been replaced with "Thinking"');
+    } else if (status.hasSillyWords) {
+      log('Status: NOT PATCHED');
+      log('Silly words are present. Run without --check to patch.');
+    } else {
+      log('Status: UNKNOWN');
+      log('Could not find silly words array. Version may not be supported.');
+    }
+    
+    if (status.hasBackup) {
+      log('Backup: available (can restore with --restore)');
+    }
+    
+    const hookStatus = getHookStatus();
+    log(`Auto-patch hook: ${hookStatus.installed ? 'installed' : 'not installed'}`);
+    
+    process.exit(status.patched ? 0 : 1);
+  }
+  
+  // Handle restore
+  if (flags.restore) {
+    const success = restoreBackup(cliInfo.path);
+    if (success) {
+      log('Restored original file from backup.');
+      log('Restart Claude Code for changes to take effect.');
+    } else {
+      error('No backup found. Cannot restore.');
+      process.exit(1);
+    }
+    process.exit(0);
+  }
+  
+  // Default action: patch
+  const result = patch(cliInfo.path, { dryRun: flags.dryRun });
+  
+  if (result.success) {
+    if (result.alreadyPatched) {
+      log('Already patched. Nothing to do.');
+    } else if (result.dryRun) {
+      log('DRY RUN - no changes made:');
+      log(result.message);
+    } else {
+      log('Patched successfully!');
+      log('Silly words replaced with "Thinking".');
+      log('Restart Claude Code for changes to take effect.');
+      
+      // Suggest installing hook
+      const hookStatus = getHookStatus();
+      if (!hookStatus.installed) {
+        log('\nTip: Run with --install-hook to auto-patch after updates.');
+      }
+    }
+    process.exit(0);
+  } else {
+    error(`Failed: ${result.message}`);
+    if (flags.verbose) {
+      showSearchedPaths();
+    }
+    process.exit(1);
+  }
+}
+
+main().catch(err => {
+  error(`Unexpected error: ${err.message}`);
+  process.exit(1);
+});