Skip to main content

The desktop app

The desktop app is linux-cleanup in a window. It bundles the same CLI this site documents and runs one mode through it: the all-safe cleanup, first as a dry run, then as a real run when you confirm. Every rule about what is removed and what is refused belongs to the CLI; the app shows those decisions and never edits them.

How it runs the CLI​

The app starts the bundled cleanup.sh with one of exactly two argument lists and reads its --json-events stream:

You pressThe app runs
Start a dry run--all-safe --yes --dry-run --json-events
Run the cleanup now--all-safe --yes --json-events

Reports and logs go to ~/.linux-cleanup/reports/ and ~/.linux-cleanup/logs/, the same folders an npx linux-cleanup run uses, so the app and the terminal share one history.

The bundled copy skips the CLI's own update check (LINUX_CLEANUP_LAUNCHER=desktop). The app checks for its own updates instead; see Install and update.

What leaves your computer​

DataLeaves the computer?
File and folder paths, file namesNever
Step results, sizes, free space before and after, the distribution nameOnly when you sign in, as numbers
Which screens open and which actions runCounted with Amplitude, without paths, names or your email

Signing in is optional. Signed out, dry runs, real runs, receipts and schedules all work on this computer; the monthly real-run allowance is counted per computer.

Removal is permanent​

A real run removes files the way the CLI does: permanently, with no copy kept. The app asks for a recent dry run before a real run, and the confirm screen says this in plain words before anything runs.