Environment Cleanup Handler

Cleans up temporary files, caches, and resources when Claude session ends

JSONbored

September 19, 2025

hooks

community

cleanup

stop-hook

maintenance

resources

optimization

Features

Key capabilities and functionality

Automatic temporary file cleanup (*.tmp, *.log, .DS_Store, Thumbs.db)
NPM cache verification and cleanup
Python bytecode and __pycache__ directory removal
Development build artifacts cleanup
Disk space usage reporting and optimization
Multi-platform support (macOS, Linux, Windows)
Safe cleanup with error handling and logging
Cache invalidation for faster future builds

Configuration

Hook configuration and script content

Hook Configuration

Script Content

Installation

Setup instructions and requirements

Claude Desktop Setup

Create the hooks directory: mkdir -p .claude/hooks
Create the script file: .claude/hooks/environment-cleanup-handler.sh
Make the script executable: chmod +x .claude/hooks/environment-cleanup-handler.sh
Add hook configuration to .claude.md file

Configuration Paths

macOS

~/.claude/config.json

windows

%APPDATA%\Claude\config.json

linux

~/.config/claude/config.json

Use Cases

Common scenarios and applications

Automated development environment maintenance
Post-session cleanup for CI/CD pipelines
Disk space optimization and management
Multi-language project artifact cleanup
Docker container development environment cleanup

Requirements

Prerequisites and dependencies

Claude Desktop or Claude Code
Node.js and npm
Python 3.x
Docker container runtime

Troubleshooting

Common issues and solutions

Node.js or npm not found
Install Node.js from https://nodejs.org/ or use nvm
Docker not running or not installed
Install Docker Desktop and ensure Docker daemon is running

Environment Cleanup Handler

Features

Configuration

Hook Configuration

Script Content

Installation

Claude Desktop Setup

Configuration Paths

Use Cases

Requirements

Troubleshooting

Resources

Hook Details

Category

Hook Type

Source

Date Added

Related Hooks

Environment Cleanup Handler

Features

Configuration

Hook Configuration

Script Content

Installation

Claude Desktop Setup

Configuration Paths

Use Cases

Requirements

Troubleshooting

Resources

Hook Details

Category

Hook Type

Source

Date Added

Related Hooks