██████████                          █████████  ████                               
░░███░░░░███                        ███░░░░░███░░███                               
 ░███   ░░███  ██████  █████ █████ ███     ░░░  ░███   ██████   ██████   ████████  
 ░███    ░███ ███░░███░░███ ░░███ ░███          ░███  ███░░███ ░░░░░███ ░░███░░███ 
 ░███    ░███░███████  ░███  ░███ ░███          ░███ ░███████   ███████  ░███ ░███ 
 ░███    ███ ░███░░░   ░░███ ███  ░░███     ███ ░███ ░███░░░   ███░░███  ░███ ░███ 
 ██████████  ░░██████   ░░█████    ░░█████████  █████░░██████ ░░████████ ████ █████
░░░░░░░░░░    ░░░░░░     ░░░░░      ░░░░░░░░░  ░░░░░  ░░░░░░   ░░░░░░░░ ░░░░ ░░░░░ 

DevClean

TUI program to help developers clean up common development output directories and build artifacts. Program is in the alpha stage. Expect lots of bugs!

Installation

1. Download the latest release from the GitHub Releases page.
2. (Optional but recommended) Verify the checksum of the downloaded binary.
3. Move the binary to a directory in your system's PATH.
   • For Linux/macOS: mv devclean ~/.local/bin/ or sudo mv devclean /usr/local/bin/
   • For Windows: Move devclean.exe to a folder that is in your system's PATH.

Usage

Basic Usage

# Scan current directory
devclean

# Scan a specific directory
devclean /path/to/your/project

Controls

Key	Action
Space or Enter	Toggle selection of a directory
d	Delete all selected directories
D	Select all SAFE directories and confirm deletion
r	Refresh the directory scan
q or Ctrl+C	Quit the application

Features

• Recursive Scan: Finds common development output folders deep within your project structure.
• Interactive UI: A simple checkbox interface to select directories for removal.
• Safety System: Directories are categorized as Safe, Moderate, or Risky to prevent accidental deletion.
• Detailed Information: Shows the path, a description, and the calculated size for each directory.
• Fast & Efficient: Uses concurrency for quick scanning with timeout protection.

Disclaimer

This software is provided "as is", without warranty of any kind, express or implied. Use at your own risk.

Contributing

Contributions are welcome! Please open an issue or submit a pull request.