Hitman

Hitman is an interactive CLI tool for Linux (Ubuntu 24.04+) that helps you safely identify and remove large files and directories from your root filesystem — without accidentally touching mounted partitions.

It is designed for system administrators, developers, and power users who need precise control over disk cleanup operations.

✨ Features

• ✅ Detects mounted filesystems and allows selective inclusion
• ✅ Defaults to scanning only / (root partition)
• ✅ Skips other partitions unless explicitly chosen
• ✅ Finds both large files and large directories
• ✅ Interactive TUI (terminal UI)
• ✅ Paginated results (default: 25 at a time)
• ✅ Delete:
• Single items
• Multiple selections
• ✅ Safe guards:
• No symlink traversal
• No accidental deletion of scan roots
• ✅ Configurable page size via environment variable

📦 Installation

Install via .deb

sudo dpkg -i hitman_*.deb
sudo apt-get install -f

🚀 Usage

sudo hitman

⚙️ Configuration

| Variable | Description | Default | |---------|------------|--------| | HITMAN_PAGE_SIZE | Items per page | 25 |

🔐 Safety Notes

This tool deletes files permanently. Always verify selections carefully.

📜 License

MIT License

👤 Maintainer

Tobias Hagenbeek