Omahub
← All plugins
Y

OmaniClean

by yooneskh

See usual non-critical cleanups and free storage from the Omarchy bar.

GitHub

Security review

No obvious issues detected

Deterministic scan — not a security guarantee

None
Risk level
None
Analyzed commit
737c746
Scanned
1 month ago

No potentially dangerous behavior detected in the analyzed commit.

Automated analysis only — not a security guarantee.

AI advisory review

No obvious issues detected

Language-model assessment · ~deepseek/deepseek-v4-flash-latest — advisory only

Low
AI risk level
Low
Recommendation
install
Model
~deepseek/deepseek-v4-flash-latest
Analyzed commit
737c746
Reviewed
1 month ago

This is a system cleaner that requires explicit user confirmation for each destructive action. It uses standard commands (paccache, rm -rf on specific cache dirs, docker system prune, etc.) and does not contain obfuscated or malicious code. The main risk is accidental deletion if the user confirms without reviewing, but that is user responsibility.

  • User-owned clean commands use `rm -rf` on paths derived from environment variables; misconfigured variables (e.g., XDG_CACHE_HOME set to /) could lead to unintended deletion.
  • The 'clean all user' feature deletes multiple caches at once, increasing the impact of a mistaken confirmation.
How this check works

This review combines the deterministic scan (the rule-based results above) with an independent look at the plugin's code by a language model. The model reads a trimmed sample of the repository's files, the manifest, and the README, then gives a plain-language risk level and a recommendation: install (no notable danger), review (look closer first), or avoid (clearly dangerous).

It runs on the same analyzed commit as the deterministic scan and is strictly advisory — it is not a security guarantee and never blocks a plugin by itself. A human moderator still reviews plugins before they are listed.

AI advisory only — automated analysis, not a security guarantee.

Install
$ omarchy plugin add https://github.com/yooneskh/omaniclean --enable
Productivity #bar

OmaniClean

An Omarchy Quattro bar plugin that lists usual, non-critical cleanups and how much storage they can free. Nothing runs until you confirm. Privileged work uses pkexec so Omarchy's polkit dialog asks for your password.

OmaniClean

This plugin never wipes ~/.cache, never deletes Snapper snapshots, never removes orphan packages, never prunes Docker volumes.

Install

omarchy plugin add https://github.com/yooneskh/omaniclean.git --enable

Usage

  • Left click the broom to open or close the panel
  • Middle click the broom to rescan
  • In the panel: j / k move, Enter cleans the selected row, r refreshes, a cleans all user-owned rows, Escape closes

Each row shows only if that cache exists and is at least 16 MB, except privileged items whose size cannot be read without root. Those still appear as size unknown.

User-owned rows (trash, thumbnails, AUR builds, language-tool caches) run in the panel after a confirm dialog. Package cache, journal vacuum, and system crash dumps ask through polkit, then rescan when they finish.

What it can clean

  • Extra pacman package versions beyond the last two, plus cached packages you already uninstalled (paccache -rk2 and paccache -ruk0)
  • Archived journal files older than seven days
  • User trash
  • Thumbnail cache
  • AUR helper build caches (yay, paru)
  • Regenerable tool caches (pip, npm, cargo, Go build, bun)
  • Unused Docker containers, dangling images, and build cache — not volumes
  • System crash dumps

What it never deletes

  • Snapper snapshots
  • Orphan packages
  • Browser profiles or the whole ~/.cache tree
  • Docker volumes or unused tagged images (docker system prune -a)
  • The last two versions in the pacman cache
  • Running processes or RAM page cache (yet)

Requirements

  • Omarchy Quattro with third-party shell plugins
  • Optional: paccache (from pacman-contrib), docker on PATH if you want those rows (in standard omarchy)

The plugin runs inside omarchy-shell as your user. Privileged cleans call system binaries through pkexec and wait for the result.

Remove

omarchy plugin remove yooneskh.omaniclean