Read the candidates
Start with a read-only scan and see the paths worth investigating.
SPACE STARTS WITH A LOOKKnow what stays.
Know what stays.
Then clean.
A full disk tells you little about what can go. linux-cleanup shows cache paths and their limits before a real removal.
The example below reads no files on your machine.
~/EXAMPLE MAP
homeYOUR FILES
.cacheREVIEW
thumbnails
fontconfig
DocumentsKEEP
A PATH
IS A CHOICE.
IS A CHOICE.
What exists todayRead-only scanDry runCLI 2.0.0Desktop app in design
01 / THE PROBLEM
Storage fills up in places you never look.
Thumbnails, package caches and old logs can accumulate behind ordinary work. Some are regenerable. Some paths need care. A single “clean” button cannot explain the difference.
02 / TRY THE SURVEY
Move a path. See the decision change.
Illustrative paths only. This preview does not inspect or remove anything on your device.
EXAMPLE PATHCHOICE
~/DocumentsPersonal files; outside this exampleKeep
SURVEY / EXAMPLE RESULT02cache paths proposed
2 generated cache paths are selected. Your Documents stay outside this example.
NOT A SCAN · NO FILES TOUCHED03 / THE BOUNDARY
Personal files are not cleanup material.
Routine cache cleanup is designed around regenerable material. The preview names its candidate paths before you choose a mode.
×No undo after removal.
The tool does not move deleted files to Trash or make a backup.
Read the limits The tool does not move deleted files to Trash or make a backup.
04 / THE ORDER
Look. Check. Decide.
Walk the run
Use a dry run to see proposed steps without deleting files.
Choose deliberately
Only a real cleanup removes selected files. That removal is permanent.
05 / MODES
One machine. Different kinds of clutter.
The CLI keeps its modes separate so the command names the work it will do.
01CacheRegenerable local cache
02LogsOld diagnostic output
03Systemapt / dpkg support in the current CLI
06 / AVAILABLE NOW
The command line is ready.
The desktop interface is being designed. The current CLI lets you begin with a read-only scan.
Get linux-cleanup on npm (opens in a new tab)TERMINAL / FIRST LOOK● ● ●
$ linux-cleanup --scanRead the paths before choosing a cleanup mode.
SCAN ONLY · NO REMOVAL
AFTER A RUNEXAMPLE STRUCTURE
Selected modeNamed in report
Removed / skippedListed separately
Refusals or errorsShown plainly
A REPORT IS NOT AN UNDO
07 / THE RESULT
Know what happened afterward.
A completed run reports its outcome. It should make the next decision easier to understand, without pretending it can reverse a deletion.
08 / LINUX REALITY
Your distribution matters.
The current system-cleanup path uses apt and dpkg. Check mode-specific support before using it on another distribution.
Inspect the source (opens in a new tab)09 / A DIFFERENT START
The answer comes before the action.
WITHOUT A PREVIEW
A full disk leads straight to guessing what is safe to delete.
WITH LINUX-CLEANUP
Named paths and a dry run give you a chance to inspect the proposed work.
10 / CURRENT RELEASE
CLI 2.0.0
The published command line release includes a read-only scan, dry run and app refresh command. A desktop download is not available yet.
DESKTOP APP / IN DESIGN11 / QUESTIONS
Before you remove anything.
Does the scan delete files?
No. --scan reads candidate paths. A cleanup mode with --dry-run walks its proposed steps without deleting files.
Can I undo a cleanup?
No. Real removal is permanent; linux-cleanup does not create a backup.
Is the desktop app available?
It is in design. The CLI is available now.
12 / THE NEXT STEP
Start by looking.
Run the read-only scan. Keep the decision close to the paths.