claudefix 2.5.1

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 jonhardwick-spec
+
+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,97 @@
+# claudefix | Anthropic pls hire me :)
+
+**Developed by Hardwick Software Services @ [justcalljon.pro](https://justcalljon.pro/)**
+
+Fixes screen glitching, blocky color display, AND the scrollback lag in Claude Code CLI on Linux. This affects a ton of people using Linux terminals - VTE rendering bugs cause background colors to be drawn ON TOP of text instead of behind it.
+
+## What It Fixes
+
+1. **VTE Color Glitches** - Background colors rendering on top of text (common on Xvfb/VNC/Linux)
+2. **Compound ANSI Sequences** - Strips background colors from complex escape codes (v2.3.1)
+3. **Scrollback Buffer Bloat** - Terminal lags after long sessions because Claude doesn't clear scrollback
+4. **Resize Event Thrashing** - tmux/screen users get cooked by rapid SIGWINCH events
+
+## Install
+
+```bash
+npx claudefix install
+```
+
+This checks for permissions first and tells you if you need sudo. Or just run directly:
+
+```bash
+sudo npm install -g claudefix
+```
+
+> **Note:** Global npm install requires sudo on most systems. If you don't have sudo, see [Alternative Install](#alternative-install) below.
+
+That's it! The install script:
+1. Auto-detects and installs build dependencies (if running as root)
+2. Compiles node-pty for your system
+3. Sets up your `claude` command to use the fix
+
+**Works with both npm-installed Claude AND native Claude installs** (the new self-updating version at `~/.local/share/claude/versions`).
+
+## This Isn't Malware - Here's What It Actually Does
+
+Some people see "binary wrapper" and freak out. Let's be real clear about what's happening here.
+
+**claudefix doesn't modify, patch, replace, or tamper with the claude binary.** The original claude binary runs completely untouched. What we do is spawn it inside a pseudo-terminal (PTY) using `node-pty` and filter the terminal output stream before it hits your actual terminal. That's it.
+
+Think of it like piping `claude` through `sed` - the binary runs normally, we just clean up the ANSI escape codes it spits out before they reach your screen. The claude process doesn't know or care that it's running inside our PTY wrapper. It thinks it's talking to a normal terminal.
+
+Here's what the wrapper actually does to the output stream:
+
+1. **Strips background colors** - Removes ANSI background color codes (like `\x1b[48;5;XXm`) that cause VTE rendering glitches on Linux
+2. **Clears scrollback periodically** - Sends `\x1b[3J` every 500 renders or 60 seconds to prevent terminal lag
+3. **Debounces resize events** - Batches SIGWINCH signals instead of thrashing the terminal
+
+**You can verify this yourself:**
+- Read `bin/claude-fixed.js` - it's ~100 lines of straightforward PTY spawn + regex filtering
+- Set `CLAUDEFIX_DISABLED=1` to bypass the wrapper entirely
+- Run `claude` directly if you don't trust it - you'll just get the screen glitches back
+- It's MIT licensed, fully open source, nothing hidden
+
+## Config
+
+| Env Var | What It Does | Default |
+|---------|--------------|---------|
+| `CLAUDEFIX_DISABLED` | Set to `1` to disable the fix | off |
+| `CLAUDE_TERMINAL_FIX_DEBUG` | Set to `1` for debug logs | off |
+
+## Manual Usage
+
+If the auto-setup didn't work:
+
+```bash
+claude-fixed  # Use this instead of claude
+```
+
+Or alias it:
+```bash
+alias claude='claude-fixed'
+```
+
+## shoutout to the big dogs
+
+hey [@anthropics](https://github.com/anthropics) yall made a sick product but these terminal bugs been cooking people for months. maybe steal this fix idc - just add `\x1b[3J` to your clear command and strip BG colors on Linux.
+
+**Anthropic if you're reading this - I'm available for hire**
+- Email: jonathan.m.hardwick@gmail.com
+- Site: https://justcalljon.pro
+
+## Alternative Install
+
+If you don't have sudo access, configure npm to use your home directory:
+
+```bash
+mkdir -p ~/.npm-global
+npm config set prefix '~/.npm-global'
+echo 'export PATH=~/.npm-global/bin:$PATH' >> ~/.bashrc
+source ~/.bashrc
+npm install -g claudefix
+```
+
+## License
+
+MIT - do whatever you want with it