Xdg-ninja: checking your $HOME for unwanted files and directories
Published on: 2025-07-01 00:43:22
xdg-ninja Because you wouldn't let just anyone into your $HOME
A shell script that checks your $HOME for unwanted files and directories.
When xdg-ninja encounters a file or directory it knows about, it will tell you whether it's possible to move it to the appropriate location, and how to do it.
The configurations are from the arch wiki page on XDG_BASE_DIR, antidot (thanks to Scr0nch for writing a conversion tool), and crowdsourced by other users.
Installing
Manual Installation
Clone the repository, then run the ./xdg-ninja.sh script.
git clone https://github.com/b3nj5m1n/xdg-ninja cd xdg-ninja ./xdg-ninja.sh
This will run every test in the default configuration.
Turn on flakes, then run the following command:
nix run github:b3nj5m1n/xdg-ninja
Note Due to how xdg-ninja is developed, releases are not cut, so Homebrew ships a stale version, therefore you have to install and upgrade xdg-ninja from the git HEAD. ref: #204 Homebrew will not upgrade xdg-ninja when running a generi
... Read full article.