Modes matrix
Every mode at a glance. Use this to answer "will this delete anything?" without reading a whole page.
The matrix
| Mode | Flag | Deletes | Interactive | sudo | Writes record |
|---|---|---|---|---|---|
| Walkthrough | (none) -w | Yes | Yes | Step 8 only | Yes |
| Menu | -m | Yes | Yes | If chosen | No |
| TUI | -t | Yes | Yes | If chosen | No |
| All-safe | -a | Yes | Unless -y | No | No |
| Scan | -s | No | No | No | No |
| Stale personal | -p | Yes | Always | No | No |
| System | --system | Yes | Yes | Yes | No |
| Partials | --partials | Yes | Always | No | No |
| Home audit | --audit | No | No | No | No |
| node_modules | --node-modules | Yes | Always | No | No |
| Globals audit | --globals | No | No | No | No |
| Doctor | --doctor | No — appends only | Yes | No | No |
| Editor extensions | --editor-ext | Yes | Yes | No | No |
| Speed | --speed | No file deletion; optional settings | Yes | No | No |
| Reports | --reports | Records only | Yes | No | No |
| Export | --export | No | No | No | No |
| Feedback | --feedback | No | Yes | No | No |
| Debug bundle | --debug-bundle | No | No | No | No |
| List targets | --list-targets | No | No | No | No |
| Self-test | --self-test | No | No | No | No |
| Version | -V | No | No | No | No |
| Install alias | --install-alias | No | Yes | No | No |
| Install cron | --install-cron | No | Yes | No | No |
| Refresh desktop app | --refresh-app | Updates app from release | Yes | No | No |
| Uninstall alias | --uninstall-alias | Alias line | Yes | No | No |
| Uninstall cron | --uninstall-cron | Cron line | Yes | No | No |
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
| Applies | Does 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-modules | Read-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
| Mode | Needs | Without it |
|---|---|---|
--tui | whiptail or dialog | Falls back to --menu with an install hint |
--export, --reports conversion | jq | JSON still written; conversion unavailable |
--install-cron | crontab | Cannot run |
--system snap step | snap | Step skipped cleanly |
--system apt steps | apt, dpkg | Fails — Debian/Ubuntu only |
Next
- CLI flags — every flag in detail
- Modes overview — grouped by purpose