GIT-PKGS(1)

💅 NAME 💅

ok so bestie, listen up: git-pkgs-licenses — the one that shows you all the license info for your dependencies ✨ literally the tool you want when you need to know what legal vibes your project is giving off.

---

🎀 SYNOPSIS 🎀

git-pkgs licenses [flags]

---

🦋 DESCRIPTION 🦋

So basically this command goes and pulls the license info for every single dependency in your project. Like, all of them, no cap. 🫶

And the best part? Licenses get normalized to SPDX identifiers when that's possible — so you're not out here decoding seventeen different ways people wrote "MIT." iconic behavior honestly. 👑

---

✨ OPTIONS ✨

• --allow=[] — an allowlist, lowkey. Only these licenses are allowed to pass, and if one violates it you get exit 1. 🚨
• -b, --branch="" — which branch to query. defaults to the current branch, obviously.
• -c, --commit="" — check the licenses as they were at a specific commit. defaults to HEAD.
• --copyleft[=false] — flags copyleft licenses for you (that's GPL, AGPL — the ones that make companies nervous 💀).
• --deny=[] — the blocklist bestie. These licenses are denied, and if one shows up you get exit 1. 🙈
• --dependencies="direct" — which dependencies to include. your choices are direct, indirect, or all. defaults to direct.
• --drift[=false] — detects dependencies whose license changed between the installed version and the latest version. im literally obsessed, this is the messy-drama detector. 🍓
• -e, --ecosystem="" — filter by ecosystem. one ecosystem only, pick your fave.
• -f, --format="text" — output format: text, json, or csv. defaults to text, as one does.
• --group[=false] — groups the output by license. so clean, so organized, main character energy. 🌸
• -h, --help[=false] — help for licenses. your little safety net. 🧚
• --license-text[=false] — includes the license and notice text from package artifacts in the JSON output. the full legal novel, if you want it. 📜
• --offline[=false] — uses cached metadata and makes zero network requests. for when the wifi is giving nothing. 💀
• --permissive[=false] — flags non-permissive licenses. yes, that's what it says. it flags the non-permissive ones. 🎀
• --unknown[=false] — flags packages with unknown licenses. the mystery boxes get called out. 🕵️

---

🌈 OPTIONS INHERITED FROM PARENT COMMANDS 🌈

these ones come from the parent command, so they're like, family traits 💖

• --color="auto" — when to colorize output: auto, always, or never. defaults to auto.
• --include-submodules[=false] — includes git submodules when scanning for manifests. don't forget the lil nested ones 🫶
• -p, --pager[=false] — use the pager for output. scroll in style.
• -q, --quiet[=false] — suppresses non-essential output. shhh. 🤫

---

👑 SEE ALSO 👑

• git-pkgs(1) — the main character herself.

---

🎀 HISTORY 🎀

28-Oct-2026 — auto generated by spf13/cobra. not me being a cobra stan 🐍✨

---

💖 okay that's the whole thing bestie, no gatekeeping. all the flags, all the defaults, all the facts — preserved, slayed, periodt. 💅

git-pkgs — Oct 2026 🌈🦋💜