Skip to main content

Modes matrix

Every mode at a glance. Use this to answer "will this delete anything?" without reading a whole page.

The matrix​

ModeFlagDeletesInteractivesudoWrites record
Walkthrough(none) -wYesYesStep 8 onlyYes
Menu-mYesYesIf chosenNo
TUI-tYesYesIf chosenNo
All-safe-aYesUnless -yNoNo
Scan-sNoNoNoNo
Stale personal-pYesAlwaysNoNo
System--systemYesYesYesNo
Partials--partialsYesAlwaysNoNo
Home audit--auditNoNoNoNo
node_modules--node-modulesYesAlwaysNoNo
Globals audit--globalsNoNoNoNo
Doctor--doctorNo — appends onlyYesNoNo
Editor extensions--editor-extYesYesNoNo
Speed--speedNo file deletion; optional settingsYesNoNo
Reports--reportsRecords onlyYesNoNo
Export--exportNoNoNoNo
Feedback--feedbackNoYesNoNo
Debug bundle--debug-bundleNoNoNoNo
List targets--list-targetsNoNoNoNo
Self-test--self-testNoNoNoNo
Version-VNoNoNoNo
Install alias--install-aliasNoYesNoNo
Install cron--install-cronNoYesNoNo
Refresh desktop app--refresh-appUpdates app from releaseYesNoNo
Uninstall alias--uninstall-aliasAlias lineYesNoNo
Uninstall cron--uninstall-cronCron lineYesNoNo

Modes that never delete anything​

These commands do not delete cleanup targets. Some write local logs, reports, exports, or diagnostic bundles:

--scan · --audit · --globals · --list-targets · --self-test · --version · --export · --feedback · --debug-bundle

--doctor belongs here too with a caveat: it modifies your shell configuration, but only by appending after confirmation. It never removes or rewrites an existing line.

Modes --yes affects​

Exactly one: --all-safe.

The interactive-data modes — --stale, --partials, --node-modules — require their own confirmations. See Guard 3.

Modes the staleness gate applies to​

AppliesDoes not apply
Cache pruning in walkthrough, menu, TUI, all-safe--system (uses its own hardcoded 7-day /tmp rule)
--editor-ext supersession--partials (age is not the criterion)
--node-modulesRead-only modes (nothing is deleted)
--stale
Developer-tool data (AVDs, flatpak, pub-cache)

--purge-all disables the gate wherever it would otherwise apply.

Which modes need optional dependencies​

ModeNeedsWithout it
--tuiwhiptail or dialogFalls back to --menu with an install hint
--export, --reports conversionjqJSON still written; conversion unavailable
--install-croncrontabCannot run
--system snap stepsnapStep skipped cleanly
--system apt stepsapt, dpkgFails — Debian/Ubuntu only

Next​