PRECIOUS(1)

📦
version 0.8.0+~0.2.1+20220602+~0.0.2 · 4 versions
, in ubuntu stonking

💖 PRECIOUS(1) 💖

okay bestie, welcome to the precious manual — the User Commands corner of the man-page universe, and specifically the tidy subcommand. buckle up 🎀

✨ NAME ✨

precious tidy — tidy/fix path(s) using tidiers 🧚

🌸 SYNOPSIS 🌸

precious tidy [OPTIONS] <--all|--git|--staged|--git-diff-from <REF>|--staged-with-stash|PATHS>

like, that's the whole vibe. you pick one of those modes (or just hand her some PATHS) and she goes 💅

🦋 DESCRIPTION 🦋

Tidy/fix path(s) using tidiers. that's it. that's the whole job. she takes your messy little files and runs your tidiers on them. glow-up time ✨

🍓 Arguments:

  • [PATHS]... — a list of paths on which to operate. literally just tell her what to fix, bestie 🫶

👑 OPTIONS 👑

  • --command <COMMAND> — the command to run. if you set this, only this command runs, so choose wisely. it should match the command name in your config file — no cap, spell it exactly 🔥
  • -a, --all — run against all files in the current directory and below. yes, all of them. going down the whole tree, main character energy 🌈
  • -g, --git — run against files that have been modified according to git. git said "these changed", so she tidies them 💜
  • -s, --staged — run against files that are staged for a git commit. the ones already in the little staging area, waiting for their moment 🎀
  • -d, --git-diff-from <REF> — run against files that are different as compared with the given <REF>. this can be a branch name, like master, or an ref name like HEAD~6 or master@{2.days.ago}. see git help rev-parse for more options. note that this will _not_ see files with uncommitted changes in the local working directory 👀
  • -v, --verbose — enable verbose output. she will simply tell you more 🗣️
  • --debug — enable debugging output. for when you need the why, not just the what 🔍
  • --staged-with-stash — run against file content that is staged for a git commit, stashing all unstaged content first. okay so, real talk: the stash push/pop tends to do weird things to the working directory, and is not recommended for scripting. she's iconic but she is chaotic 💀
  • --label <LABEL> — if this is set, then only commands matching this label will be run. if this isn't set then commands without a label or with the label default will be run. label girlies, this one's for you 🏷️
  • --trace — enable tracing output (maximum logging). the most she will ever talk. every single detail, fr fr 📢
  • -h, --help — print help 🆘
  • -V, --version — print version 🌟
⚠️ quick heads up bestie: -d, --git-diff-from <REF> straight up does not see files with uncommitted changes in the local working directory, and --staged-with-stash messes with your working directory in weird ways, so don't script it. love her anyway 💖

and that's the whole page! mwah 😘 this one's from precious tidy, version 0.8.0+~0.2.1+2022..., dated June 2026 — keep that PRECIOUS(1) in your heart always 👑💅✨

📦 where this page comes from