Skip to content
Back to search

omarchy-cleaner

Quickly and easily remove pre-installed apps and webapps.

Safety scan

A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.

Checked today
Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/maxart--omarchy-cleaner/badge.svg)](/listings/maxart--omarchy-cleaner)

HTML

<a href="/listings/maxart--omarchy-cleaner"><img src="/api/listings/maxart--omarchy-cleaner/badge.svg" alt="findsafeskills safety rating" /></a>

Install

i

Install instructions from the README

As written by the repo's author. findsafeskills has not verified these steps.

These steps run a script from the network that findsafeskills does not scan.

curl -fsSL https://raw.githubusercontent.com/maxart/omarchy-cleaner/main/omarchy-cleaner.sh | bash

What was scanned

The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.

README.md · README · 50 lines

View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)

This file has changed since it was scanned, so this is not exactly the text that was scanned, and no line is marked. The findings are listed with the safety scan above.

  1. # Omarchy Cleaner
  2. Choose which default [Omarchy](https://github.com/omacom/omarchy) packages, webapps, terminal launchers, and CLI tools to remove through an interactive terminal menu.
  3. ## Run
  4. Run as your normal user in an Omarchy terminal:
  5. ```bash
  6. curl -fsSL https://raw.githubusercontent.com/maxart/omarchy-cleaner/main/omarchy-cleaner.sh | bash
  7. ```
  8. Type to filter, press Tab to select items, then Enter to review descriptions and confirm. Nothing is preselected.
  9. Cleaner 3.3 is live-tested on Omarchy **4.5.0 and 4.0.6**. See the [compatibility and validation report](docs/v4.5.0-compatibility.md) for coverage and limitations.
  10. ## What removal does
  11. - **Packages:** previews the complete removal, keeps packages still required by other installed packages, then runs one `pacman -Rns` transaction with sudo. This removes unused dependencies and package backup configs too. A failed preview aborts removal; a changed plan keeps packages and their shortcuts. Avoid running another package manager during cleanup.
  12. - **Webapps and terminal launchers:** removes selected launchers through Omarchy's helpers. Items labelled **shortcut only** require shortcut-cleanup consent.
  13. - **Individual CLI entries:** deletes recognized legacy wrappers in `~/.local/bin`. Customized files and symlinks stay.
  14. - **Omarchy default CLI tools (all):** opts out of the entire 4.5 default mise tool set, **including Node.js and uv**. Confirmation lists every tool. Individual lazy defaults cannot be removed separately. Installed tools, caches, personal/project declarations, and unselected legacy wrappers stay.
  15. Optional shortcut cleanup backs up your bindings, removes supported literal bindings, and disables packaged shortcuts before your personal overrides. It runs only for successful removals. Computed or multiline bindings need manual editing.
  16. The CLI group also backs up existing mise settings and attempts recovery if shim refresh fails. Conflicting personal ignore lists and linked settings are refused.
  17. ## Customize the catalogue
  18. Edit `DEFAULT_APPS`, `DEFAULT_WEBAPPS`, `DEFAULT_TUIS`, or `DEFAULT_NPM_CLIS` in the script. Uncomment package entries to expand the offering. Older entries remain available when detected; the 4.5 CLI group always covers the complete upstream declaration file.
  19. Architecture-specific packages are grouped in a commented section. Some provide boot, firmware, graphics, or audio support; inclusion does not mean they are safe to remove.
  20. ## Development
  21. Run the isolated checks:
  22. ```bash
  23. bash -n omarchy-cleaner.sh
  24. shellcheck omarchy-cleaner.sh
  25. python3 -m unittest discover -s tests -v
  26. ```
  27. Tests use temporary homes and stubbed removal commands. GitHub Actions runs these checks; real-gum selector tests run when `gum` is available. Runtime changes also require the [disposable VM workflow](skills/omarchy-vm-testing/SKILL.md).
  28. See [contributor guidance](AGENTS.md), [fixture provenance](tests/fixtures/README.md), and [description sources](docs/item-descriptions.md).
  29. ## License
  30. [MIT](LICENSE).

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.