# b3nj5m1n/xdg-ninja

A shell script which checks your $HOME for unwanted files and directories.

Repository: https://github.com/b3nj5m1n/xdg-ninja
Canonical: https://ross.abutalabs.com/products/xdg-ninja
Language: Haskell
License: MIT
License Family: permissive
Topics: linux, shell, terminal, xdg, xdg-basedir, xdg-compliance
Last push: 2026-05-10T15:09:36+00:00

## Health v2 (maintenance only)
Score: 59/100 (v2, computed 2026-09-02T17:46:02.011165+00:00)
- activity 81, release rhythm 8, longevity 100
- inputs: {"age_days": 1574, "days_push": 115, "days_rel": null, "gap_med": null, "n_releases_24m": 0}
- flags: none
- formula: round(0.45*activity + 0.35*rhythm + 0.20*longevity); archived -> min(score, 10)

## Adoption (not part of the score)
Stars 3360, forks 186 (observed 2026-08-28T04:07:58.059623+00:00)

## What it is
A shell script that scans your $HOME directory for files and directories that should be relocated according to the XDG Base Directory specification. For each unwanted file it finds, it tells you whether the program supports moving it and how to do so.

## Use cases
- clean up dotfiles cluttering my home directory
- check which programs don't follow xdg base directory spec
- find unwanted files in $HOME
- move config files to ~/.config
- audit my home directory for stray dotfiles
- make my linux home directory tidy

## When to choose
- you want a tidy $HOME that follows the XDG Base Directory specification
- you're setting up a new Linux or macOS machine and want to keep dotfile clutter minimal
- you want actionable instructions for relocating each offending file
- you prefer a dependency-light shell script (just jq and find)

## When to avoid
- you need automatic migration of files rather than instructions to do it manually
- you're on Windows or another system without a POSIX shell environment
- you need a GUI or persistent monitoring of home directory cleanliness

## Facets
- artifact type: cli-tool
- maturity: active
- function: developer-tools, cli, file-system, configuration-management
- domain: developer-tools, operating-systems, self-hosted
- platform: cli, cross-platform
- tags: xdg-base-dir, shell-script, dotfiles, home-directory-cleanup, system-hygiene, command-line, linux, macos

## Member repositories
- b3nj5m1n/xdg-ninja (main) score 59

## Provenance
- Observed fields: from GitHub, fetched 2026-08-28T04:07:58.059623+00:00.
- Health v2: computed from the inputs above; adoption is never an input.
- Inferred fields (summary, facets, guidance): AI-extracted, prompt v1, taxonomy v1, on 2026-08-29T18:40:21.312355+00:00, confidence not recorded.
  - readme: https://github.com/b3nj5m1n/xdg-ninja (fetched 2026-08-28T04:07:58.059623+00:00, sha c79dbf7f3771)
- Data as of 2026-08-30T08:39:29.467469+00:00.