README.md

May 20, 2026 ยท View on GitHub

Go Report Card Build GitHub Stars
Platform

CrunchyCleaner Logo

Preview

๐Ÿงน A lightweight, software cache cleanup tool for Windows & Linux.

Made by: Knuspii, (M)

  • Cross-Platform: Works on both Windows and Linux
  • Lightweight: Single binary, no dependencies (just download and run it)
  • TUI (Text-UI): Simple, minimalist interface, no confusing menus

Supported Software List:

CategorySoftware / Path
SystemSystem Logs, System Temp Folders, Thumbnail Cache, Shader Cache
BrowsersFirefox, Google Chrome, Microsoft Edge, Brave, Opera
DevelopmentVisual Studio Code, Slack, JetBrains IDE, Go, Pip, NPM, Yarn, Cargo, NuGet, Gradle
GamingSteam, Epic Games(Heroic)
AppsDiscord, Spotify, Thunderbird, Telegram

Flatpak is supported
Snap is not supported

๐Ÿ“ฅ How to Install & Download Download

Paste the corresponding command into your terminal and restart it afterwards.
For Linux (using sudo):

curl -L https://github.com/Knuspii/CrunchyCleaner/releases/latest/download/crunchycleaner -o cc && sudo install -m 755 cc /usr/local/bin/crunchycleaner && rm cc

For Windows (using Powershell as Admin):

$d="$env:ProgramFiles\CrunchyCleaner"; md $d -F; iwr "https://github.com/Knuspii/CrunchyCleaner/releases/latest/download/crunchycleaner.exe" -OutFile "$d\crunchycleaner.exe"; $p=[Environment]::GetEnvironmentVariable('Path',2); if($p -notlike "$d"){[Environment]::SetEnvironmentVariable('Path',"$p;$d",2)}

For Go (using go install):

go install github.com/knuspii/crunchycleaner/v2@latest

After that you can just type crunchycleaner -v into your terminal to verify it's installed. \

Or download the binary and just run/open it: [Download here]


Options:

  -a    Automate cleaning (select all and start immediately)
  -d    Simulation mode without deleting files (for testing)
  -t    Skip terminal resizing and environment initialization
  -v    Display version information

If you only use a terminal, you might want to use the -t flag.


Warning

You use this tool at your own risk!

Note

AI was used for this project in some parts.

Q&A

Q: Will this break my system?
A: No.

Q: What does it actually delete?
A: Only cache files and temp files.

Q: Why another cleaner?
A: Because this one is easy, simple, small and lightweight.

Other Downloads

CrunchyCleaner is also available on SourceForge
Download CrunchyCleaner Download CrunchyCleaner

Awesome TUIs Awesome Go Awesome Windows

External Dependencies

This project uses the following external dependencies: