claude-code-image-sanitizer

Claude Code Image Sanitizer prevents and fixes session corruption caused by oversized images from MCP screenshot tools like Playwright, Puppeteer, and Chrome DevTools, or from drag-and-drop uploads. The tool automatically resizes images before they corrupt your session, and includes a repair command to fix already-corrupted sessions without losing context. It hooks into Claude Code's image processing pipeline to enforce safe dimension and file size limits while maintaining image quality. Operations teams and developers handling large visual inputs benefit from avoiding the /clear workaround that loses all conversation history.

[{"step":"Install the skill in your Claude Code environment by running `claude install claude-code-image-sanitizer` in the terminal.","tip":"Ensure you have write permissions to the current directory and at least 100MB of free disk space for temporary files."},{"step":"Run the sanitizer on your target directory with: `claude-code-image-sanitizer --max-dimension 2048 --max-size 5MB --format JPEG`","tip":"Use `--dry-run` first to preview changes without modifying files. Add `--verbose` for detailed logs."},{"step":"For corrupted sessions, use: `claude-code-image-sanitizer --repair-session session_2024-05-15_14-30-22.json`","tip":"The tool will create a backup of the original session before attempting repairs. Check `/tmp/claude-repair-logs/` for recovery details."},{"step":"Review the generated report and verify all images are accessible in the resumed session.","tip":"If any images still appear corrupted, manually replace them with the sanitized versions from the cache directory."},{"step":"Integrate the skill into your MCP screenshot workflow by adding it as a post-processing step in your automation scripts.","tip":"For CI/CD pipelines, use `claude-code-image-sanitizer --batch` to process multiple sessions sequentially."}]