GIT-PKGS(1)

📦 version 0.21.0, in nixpkgs unstable

💅 GIT-PKGS(1) — the Git Pkgs Manual, bestie

okay so. welcome to git-pkgs, and specifically the health command, which is like the vibe check for your dependencies' maintainer energy. this page is your whole cheat sheet, fr fr. read it, love it, keep it 🫶

✨ NAME ✨

git-pkgs-health — shows you dependency maintenance health scores (yes, like a report card for the packages you're trusting with your entire codebase, no biggie 💀)

✨ SYNOPSIS ✨

git-pkgs health [flags]

that's it. that's the whole invocation. flags are optional but lowkey iconic, keep reading 🎀

✨ DESCRIPTION ✨

It scores dependency maintenance health using cached package metadata from ecosyste.ms. so it's not out here pinging the whole internet — it's pulling from the cache, which means your little health check is chill and fast. slay. ⭐

✨ OPTIONS ✨

  • --all[=false] — include transitive dependencies from lockfiles. yes, the whole dependency tree, not just your direct faves. defaults to false, so it's opt-in bestie 🌸
  • -b, --branch="" — which branch to query. default is the current branch, aka wherever you already are 🦋
  • -c, --commit="" — check dependencies at a specific commit. default is HEAD, so it's looking at your latest 👑
  • -e, --ecosystem="" — filter by ecosystem. you know, to narrow the vibes down 🧚
  • -f, --format="text" — output format. options are text and json. default is text 💖
  • -h, --help[=false] — help for health. the classic. it's giving "read the manual" but the manual is this 🎀
  • --threshold=100 — only show dependencies with health scores at or below this threshold. and important detail: the at-risk count uses this same threshold, so don't be surprised when the numbers match, iykyk 🔥

✨ OPTIONS INHERITED FROM PARENT COMMANDS ✨

these bad boys come from the parent command, so they're not even health's own, but they show up and they matter:

  • --color="auto" — when to colorize output. your choices: auto, always, never. default is auto, so it just reads the room 🌈
  • --include-submodules[=false] — include git submodules when scanning for manifests. defaults to false. turn it on if you've got submodules lurking 🙈
  • -p, --pager[=false] — use a pager for output. defaults to false 💜
  • -q, --quiet[=false] — suppress non-essential output. for when you want the tea but not the small talk 🤫

✨ SEE ALSO ✨

✨ HISTORY ✨

28-Oct-2026 — auto generated by spf13/cobra. yes, a robot wrote the history section. we respect the robot. 🫶

heads up bestie: the --threshold=100 default means by default literally everything with a score at or below 100 shows up, and the at-risk count tracks that same number. so if you want a narrower list, that's the knob to twist 🔥

okay that's the whole page, you're officially a git-pkgs health expert, go be the main character of your dependency hygiene 💅✨

source: git-pkgs · version dated Oct 2026 🎀💖🦋

📦 where this page comes from