poi-tracker(1)

📦
version 0.27.0 · 5 versions
, in fedora 43, fedora 44

🌸 poi-tracker(1) — the Sandogasa Manual, bestie edition 🌸

okay so. sit down. hydrate. we're learning poi-tracker, and honestly? it's giving main character energy. it's the Package-Of-Interest tracker for Fedora, EPEL, and CentOS SIGs, and yes i'm gonna walk you through every single flag because you deserve the full picture, not a vibe-summary. no cap. 💅

✨ NAME ✨

poi-tracker — Package-of-interest tracker for Fedora, EPEL, and CentOS SIGs

like. that's the whole name. that's her. 🎀

🦋 SYNOPSIS 🦋

poi-tracker [-i|--inventory] [-I|--inventory-dir] [-C|--directory]
[-w|--workspace] [--closure] [-h|--help] [-V|--version] <subcommands>

she's a dispatcher, bestie — you give her a subcommand and she goes off. 🫶

💖 DESCRIPTION 💖

Package-of-interest tracker for Fedora, EPEL, and CentOS SIGs

periodt. that's the description. it does what it says on the tin and it does it iconically. 💜

🌈 OPTIONS 🌈

these are the global ones — the ones that ride along with basically everything. 🌸

  • -i, --inventory <INVENTORY> — exactly these inventory TOML file(s), and yes it's repeatable. this is the most specific of the three ways to name inventories and she is always honoured: if a workspace file tries to supply an inventory, -i overrides it. -i said what it said. 💅
  • -I, --inventory-dir <DIR> — treat every *.toml in DIR as an inventory, roles unknown. made for the commands that don't care who's who (show, find, validate, export). got a specific file in mind? use -i. need to say which inventory is which? use a workspace. 🧚
  • -C, --directory <DIR> — run as if you'd started in DIR. literally git -C behaviour: the workspace file, the relative inventory paths, and the outputs all get looked up there. so you don't have to cd like a peasant. 🎀
  • -w, --workspace <PATH> — the workspace file (default: ./kondo.toml when it's present) that names which inventory is which — owned, keeps, derived, retired, cull — plus the graph and walk settings, so every subcommand already knows its inputs without you typing -i. she only fills in flags you didn't give on the command line, and --no-defaults makes her ignore it entirely. 🦋
  • --closure <NAME> — which [[closure]] of the workspace a walk subcommand is working on. default: the first one. ⭐
  • -h, --help — print help. the classic. 🫶
  • -V, --version — print version. 💖

👑 COMMANDS 👑

okay this is the fun part. the subcommands. each one gets its own little section because they're all iconique in their own way. 🌟

🎀 poi-tracker act

poi-tracker act [-i|--inventory] [-I|--inventory-dir] [--pattern]
[-C|--directory] [--start-from] [--end-with] [-w|--workspace]
[--closure] [--personal] [--branch] [--api-token] [--refresh-acls]
[-v|--verbose] [-h|--help] <--user>

enact the standing cull verdicts, interactively: orphan, remove own ACL, or give each package away — and the inventories get adjusted as you go. it's a whole little ceremony. 🕯️

  • -i, --inventory <INVENTORY> — exactly these inventory TOML file(s) (repeatable). the most specific of the three ways to name inventories, and always honoured: it overrides whatever a workspace file would supply. 💅
  • --user <USER> — the FAS username whose ACL actions these are. required, bestie, she won't go without it. 🌸
  • -I, --inventory-dir <DIR> — every *.toml in DIR as an inventory, roles unknown. for commands that treat inventories alike (show, find, validate, export). use -i to pick files, or a workspace to say which is which. 🧚
  • --pattern <GLOB,...> — only process packages matching this glob (e.g. rust-*; a bare name matches exactly). comma-separated or repeated; default: all packages. 🌈
  • -C, --directory <DIR> — run as if started in DIR (like git -C): the workspace file, relative inventory paths and outputs are looked up there. 🎀
  • --start-from <NAME> — resume from this package onwards, inclusive, in the inventory's iteration order. 🦋
  • --end-with <NAME> — stop after this package, inclusive. combine it with --start-from to bound a sub-range. ⭐
  • -w, --workspace <PATH> — workspace file (default: ./kondo.toml when present) naming which inventory is which — owned, keeps, derived, retired, cull — plus the graph and walk settings, so each subcommand knows its inputs without -i. only fills flags not given on the command line; --no-defaults ignores it. 💖
  • --closure <NAME> — which [[closure]] of the workspace a walk subcommand works on (default: the first). 🫶
  • --personal <PATH> — personal inventory to drop enacted packages from. 🙈
  • --branch <BRANCH> [default: auto] — branch(es) for the reverse-dependency probe before an orphan (CSV or repeated). the default auto derives them per package from its dist-git branches: rawhide plus its own EPEL branches. lowkey important: an EPEL-only package's dependents are invisible from rawhide. 💀
  • --api-token <API_TOKEN> — dist-git API token (or PAGURE_API_TOKEN, or run poi-tracker config). may also be specified with the PAGURE_API_TOKEN environment variable. 🔥
  • --refresh-acls — ignore the day-fresh ACL cache and look every level up again. no shortcuts today. 💅
  • -v, --verbose — log each access lookup. 👑
  • -h, --help — print help. 🎀

🌸 poi-tracker add

poi-tracker add [-i|--inventory] [--poc] [-I|--inventory-dir] [--reason]
[-C|--directory] [--team] [--task] [-w|--workspace] [--closure] [--rpm]
[--workload] [--track] [-h|--help] <NAME>

add a package to the inventory. simple. iconic. 💜

  • -i, --inventory <INVENTORY> — exactly these inventory TOML file(s) (repeatable) — the most specific of the three ways to name inventories, and always honoured: it overrides whatever a workspace file would supply. 🦋
  • --poc <POC> — point of contact, formatted "Name <email>". 📧
  • -I, --inventory-dir <DIR> — every *.toml in DIR as an inventory, roles unknown — for commands that treat inventories alike (show, find, validate, export). use -i to pick files, or a workspace to say which is which. 🌈
  • --reason <REASON> — reason for tracking. always document yourself, bestie. ⭐
  • -C, --directory <DIR> — run as if started in DIR (like git -C): the workspace file, relative inventory paths and outputs are looked up there. 💖
  • --team <TEAM> — team responsible. 🫶
  • --task <TASK> — internal task/ticket reference. 🎀
  • -w, --workspace <PATH> — workspace file (default: ./kondo.toml when present) naming which inventory is which — owned, keeps, derived, retired, cull — plus the graph and walk settings, so each subcommand knows its inputs without -i. only fills flags not given on the command line; --no-defaults ignores it. 🌸
  • --closure <NAME> — which [[closure]] of the workspace a walk subcommand works on (default: the first). ✨
  • --rpm <RPM> — binary RPM subpackage(s) to track (comma-separated or repeated). 📦
  • --workload <WORKLOAD> — workload tag(s) (comma-separated or repeated). 🏷️
  • --track <TRACK> — track branch for hs-relmon (e.g. upstream, fedora-rawhide). 🛤️
  • -h, --help — print help. 💅
  • <NAME> — source RPM name. the thing you're adding. that's her. 👑

🧚 poi-tracker adopt

poi-tracker adopt [-i|--inventory] [--pattern] [-I|--inventory-dir]
[--start-from] [-C|--directory] [--end-with] [--api-token]
[-w|--workspace] [--closure] [--dry-run] [-y|--yes] [-v|--verbose]
[-h|--help]

adopt orphaned inventory packages on dist-git. found family, but for RPMs. 🥺

  • -i, --inventory <INVENTORY> — exactly these inventory TOML file(s) (repeatable) — the most specific of the three ways to name inventories, and always honoured: it overrides whatever a workspace file would supply. 💅
  • --pattern <GLOB,...> — only process packages matching this glob (e.g. rust-*; a bare name matches exactly). comma-separated or repeated; default: all packages. 🌈
  • -I, --inventory-dir <DIR> — every *.toml in DIR as an inventory, roles unknown — for commands that treat inventories alike (show, find, validate, export). use -i to pick files, or a workspace to say which is which. 🦋
  • --start-from <NAME> — resume from this package onwards (inclusive), in the inventory's iteration order. ⭐
  • -C, --directory <DIR> — run as if started in DIR (like git -C): the workspace file, relative inventory paths and outputs are looked up there. 🎀
  • --end-with <NAME> — stop after this package (inclusive). combine with --start-from to bound a sub-range. 💖
  • --api-token <API_TOKEN> — dist-git API token with the modify_project ACL (or set PAGURE_API_TOKEN, or run poi-tracker config). may also be specified with the PAGURE_API_TOKEN environment variable. 🔥
  • -w, --workspace <PATH> — workspace file (default: ./kondo.toml when present) naming which inventory is which — owned, keeps, derived, retired, cull — plus the graph and walk settings, so each subcommand knows its inputs without -i. only fills flags not given on the command line; --no-defaults ignores it. 🌸
  • --closure <NAME> — which [[closure]] of the workspace a walk subcommand works on (default: the first). ✨
  • --dry-run — preview orphaned packages without adopting them. look but don't touch. 👀
  • -y, --yes — adopt every orphaned match without per-package prompts. yes to all, no regrets. 🫶
  • -v, --verbose — print progress to stderr. 📣
  • -h, --help — print help. 💅

💜 poi-tracker announce

poi-tracker announce [-i|--inventory] [-I|--inventory-dir]
[--refresh-acls] [-C|--directory] [-v|--verbose] [--json]
[-w|--workspace] [--closure] [-h|--help] <--user>

render the standing cull verdicts as the grouped, announcement-ready report, with runnable ACL commands. it's the press-release version. 📢👑

  • -i, --inventory <INVENTORY> — exactly these inventory TOML file(s) (repeatable) — the most specific of the three ways to name inventories, and always honoured: it overrides whatever a workspace file would supply. 🎀
  • --user <USER> — FAS username whose access level routes each action. required. 🌸
  • -I, --inventory-dir <DIR> — every *.toml in DIR as an inventory, roles unknown — for commands that treat inventories alike (show, find, validate, export). use -i to pick files, or a workspace to say which is which. 🦋
  • --refresh-acls — ignore the day-fresh ACL cache and look every level up again. 💅
  • -C, --directory <DIR> — run as if started in DIR (like git -C): the workspace file, relative inventory paths and outputs are looked up there. ⭐
  • -v, --verbose — log each access lookup. 🔍
  • --json — output machine-readable JSON. for the robots. 🤖
  • -w, --workspace <PATH> — workspace file (default: ./kondo.toml when present) naming which inventory is which — owned, keeps, derived, retired, cull — plus the graph and walk settings, so each subcommand knows its inputs without -i. only fills flags not given on the command line; --no-defaults ignores it. 💖
  • --closure <NAME> — which [[closure]] of the workspace a walk subcommand works on (default: the first). 🌈
  • -h, --help — print help. 🫶

🦋 poi-tracker config

poi-tracker config [-i|--inventory] [-I|--inventory-dir]
[-C|--directory] [-w|--workspace] [--closure] [-h|--help]

configure poi-tracker (Bugzilla API key, etc.). the getting set up era. ✨

  • -i, --inventory <INVENTORY> — exactly these inventory TOML file(s) (repeatable) — the most specific of the three ways to name inventories, and always honoured: it overrides whatever a workspace file would supply. 💅
  • -I, --inventory-dir <DIR> — every *.toml sitting in DIR gets treated as an inventory, roles unknown 💫 — perfect for the commands that don't care who's who (show, find, validate, export). Wanna be picky about which files? use -i. Wanna say which inventory is which? use a workspace, bestie.
  • -C, --directory <DIR> — run like you literally started in DIR, exactly like git -C does it 🌸: the workspace file, any relative inventory paths, and your outputs all get looked up from there.
  • -w, --workspace <PATH> — the workspace file (default: ./kondo.toml when present 👀) that names which inventory is which — owned, keeps, derived, retired, cull — plus all the graph and walk settings, so every subcommand already knows its inputs without you passing -i. It only fills in flags you didn't give on the command line, and --no-defaults makes it ignore the whole thing.
  • --closure <NAME> — which [[closure]] of the workspace a walk subcommand should work on (default: the first one 🥇).
  • -h, --help — print help ✨

🫶 poi-tracker dependents 🫶

poi-tracker dependents [-i|--inventory] [-I|--inventory-dir] [--json]
[-C|--directory] [-w|--workspace] [--closure] [-h|--help] <--graph>

Classify your inventory packages by who depends on them, working off a saved dependency graph: the leaves, the ones other keeps carry, and the ones the outside world needs 🦋

  • --graph <PATH> — a dependency graph JSON, straight out of a deps --graph run ⭐
  • -i, --inventory <INVENTORY> — exactly these inventory TOML file(s) (repeatable 🔁) — this is the most specific of the three ways to name inventories, and it is always honoured: it overrides anything a workspace file would've supplied. periodt 💅
  • -I, --inventory-dir <DIR> — every *.toml in DIR as an inventory, roles unknown — for the commands that treat inventories alike (show, find, validate, export). Use -i to pick files, or a workspace to say which is which 💖
  • --json — output machine-readable JSON 🤖
  • -C, --directory <DIR> — run as if started in DIR (like git -C): the workspace file, relative inventory paths and outputs are looked up there 🌈
  • -w, --workspace <PATH> — workspace file (default: ./kondo.toml when present) naming which inventory is which — owned, keeps, derived, retired, cull — plus the graph and walk settings, so each subcommand knows its inputs without -i. Only fills flags not given on the command line; --no-defaults ignores it 👑
  • --closure <NAME> — which [[closure]] of the workspace a walk subcommand works on (default: the first)
  • -h, --help — print help

💀 poi-tracker deps 💀

poi-tracker deps [-i|--inventory] [--pattern] [-I|--inventory-dir]
[--start-from] [-C|--directory] [--end-with] [-w|--workspace]
[--closure] [-r|--repo] [--from] [--base-repo] [--runtime-only]
[--graph] [--fixpoint] [-o|--output] [--name] [--json] [-v|--verbose]
[-h|--help] <-b|--branch>

Inventory all the dependencies you're pulling from other repos (EPEL core, that vibe 😌)

  • -i, --inventory <INVENTORY> — exactly these inventory TOML file(s) (repeatable) — the most specific of the three ways to name inventories, and always honoured: it overrides whatever a workspace file would supply 💖
  • --pattern <GLOB,...> — only process packages matching this glob (so like rust-*; a bare name matches exactly 🔍). Comma-separated or repeated; default: all packages.
  • -I, --inventory-dir <DIR> — every *.toml in DIR as an inventory, roles unknown — for commands that treat inventories alike (show, find, validate, export). Use -i to pick files, or a workspace to say which is which.
  • --start-from <NAME> — resume from this package onwards (inclusive), following the inventory's iteration order ⏩
  • -C, --directory <DIR> — run as if started in DIR (like git -C): the workspace file, relative inventory paths and outputs are looked up there.
  • --end-with <NAME> — stop after this package (inclusive). Pair it with --start-from to box in a sub-range 🎀
  • -b, --branch <BRANCH> — fedrq branch (e.g. hs.el9, epel9) 🌿
  • -w, --workspace <PATH> — workspace file (default: ./kondo.toml when present) naming which inventory is which — owned, keeps, derived, retired, cull — plus the graph and walk settings, so each subcommand knows its inputs without -i. Only fills flags not given on the command line; --no-defaults ignores it.
  • --closure <NAME> — which [[closure]] of the workspace a walk subcommand works on (default: the first).
  • -r, --repo <REPO> — fedrq repo class (e.g. stack) 📦
  • --from <FROM> [default: epel] — collect providers from these repo ids (CSV or repeated). Exact match. The default suits an EPEL walk; for a Fedora walk, pass the branch's own repo id, e.g. --from rawhide. no cap 🧚
  • --base-repo <BASE_REPO> [default: fedrq-centos-stream-] — base-distro repo id prefix(es); their providers end the walk. The default treats CentOS Stream as the given beneath an EPEL stack. A Fedora walk has no base distro — the default then never matches, and everything resolves within --from's repos, which is exactly what you want 😌✨
  • --runtime-only — walk runtime dependencies only, and don't seed the roots' BuildRequires 🙈
  • --graph <PATH> — where to write the walk's full dependency graph (every single requirer/provider edge, not just first attributions) as JSON. Default: beside -o, as <output>-graph.json 📊
  • --fixpoint <PATH> — iterate to a fixpoint: collected packages found in this inventory (yours!) become roots whose BuildRequires seed further rounds 🔁
  • -o, --output <OUTPUT> — write the collected dependencies as an inventory TOML file 💾
  • --name <NAME> — inventory name for --output (default: "<input name>-deps-<branch>") 🏷️
  • --json — output as JSON instead of human-readable
  • -v, --verbose — print progress to stderr 👀
  • -h, --help — print help (see a summary with '-h')

🌸 poi-tracker derive 🌸

poi-tracker derive [-i|--inventory] [-I|--inventory-dir]
[-C|--directory] [--apply] [-w|--workspace] [--closure] [--json]
[-h|--help] <--graph> <--owned> <-o|--output>

Recompute a derived dependency inventory offline from a saved graph: every owned package the keeps can reach 🦋

  • --graph <PATH> — dependency graph JSON from a deps --graph run ⭐
  • -i, --inventory <INVENTORY> — exactly these inventory TOML file(s) (repeatable) — the most specific of the three ways to name inventories, and always honoured: it overrides whatever a workspace file would supply 💅
  • -I, --inventory-dir <DIR> — every *.toml in DIR as an inventory, roles unknown — for commands that treat inventories alike (show, find, validate, export). Use -i to pick files, or a workspace to say which is which.
  • --owned <PATH> — inventory of the packages you own (e.g. a sync-distgit output); only owned packages enter the derived inventory 👑 no sneaking in, bestie
  • -C, --directory <DIR> — run as if started in DIR (like git -C): the workspace file, relative inventory paths and outputs are looked up there.
  • -o, --output <PATH> — the derived inventory to recompute 🎀
  • --apply — replace the output file's packages; without it, you just get a report, nothing gets touched 🙈
  • -w, --workspace <PATH> — workspace file (default: ./kondo.toml when present) naming which inventory is which — owned, keeps, derived, retired, cull — plus the graph and walk settings, so each subcommand knows its inputs without -i. Only fills flags not given on the command line; --no-defaults ignores it.
  • --closure <NAME> — which [[closure]] of the workspace a walk subcommand works on (default: the first).
  • --json — output machine-readable JSON 🤖
  • -h, --help — print help

💜 poi-tracker export 💜

poi-tracker export [-i|--inventory] [-I|--inventory-dir]
[-C|--directory] [-w|--workspace] [--closure] [-h|--help] <subcommands>

Export inventory to another format 📤✨

  • -i, --inventory <INVENTORY> — exactly these inventory TOML file(s) (repeatable) — the most specific of the three ways to name inventories, and always honoured: it overrides whatever a workspace file would supply 💖
  • -I, --inventory-dir <DIR> — every *.toml in DIR as an inventory, roles unknown — for commands that treat inventories alike (show, find, validate, export). Use -i to pick files, or a workspace to say which is which.
  • -C, --directory <DIR> — run as if started in DIR (like git -C): the workspace file, relative inventory paths and outputs are looked up there.
  • -w, --workspace <PATH> — workspace file (default: ./kondo.toml when present) naming which inventory is which — owned, keeps, derived, retired, cull — plus the graph and walk settings, so each subcommand knows its inputs without -i. Only fills flags not given on the command line; --no-defaults ignores it.
  • --closure <NAME> — which [[closure]] of the workspace a walk subcommand works on (default: the first).
  • -h, --help — print help

🎀 poi-tracker export content-resolver 🎀

poi-tracker export content-resolver [-i|--inventory] [--workload]
[-I|--inventory-dir] [-o|--output] [-C|--directory] [-w|--workspace]
[--closure] [-h|--help]

Export as content-resolver YAML 🧾✨

  • -i, --inventory <INVENTORY> — exactly these inventory TOML file(s) (repeatable) — the most specific of the three ways to name inventories, and always honoured: it overrides whatever a workspace file would supply 💅
  • --workload <WORKLOAD> — export only this workload 🎯
  • -I, --inventory-dir <DIR> — every *.toml in DIR as an inventory, roles unknown — for commands that treat inventories alike (show, find, validate, export). Use -i to pick files, or a workspace to say which is which.
  • -o, --output <OUTPUT> — output file (default: {workload-name}.yaml) 💾
  • -C, --directory <DIR> — run as if started in DIR (like git -C): the workspace file, relative inventory paths and outputs are looked up there.
  • -w, --workspace <PATH> — workspace file (default: ./kondo.toml when present) naming which inventory is which — owned, keeps, derived, retired, cull — plus the graph and walk settings, so each subcommand knows its inputs without -i. Only fills flags not given on the command line; --no-defaults ignores it.
  • --closure <NAME> — which [[closure]] of the workspace a walk subcommand works on (default: the first).
  • -h, --help — print help

🫶 poi-tracker export hs-relmon

poi-tracker export hs-relmon [-i|--inventory] [--workload]
[-I|--inventory-dir] [-o|--output] [-C|--directory] [--distros]
[--track] [-w|--workspace] [--closure] [--prune] [-h|--help]

Okay so this one ships it all out as an hs-relmon manifest TOML ✨

  • -i, --inventory <INVENTORY> — literally these inventory TOML file(s), and yes you can repeat it. This is the most specific of the three ways to name inventories and it is always honoured — it overrides whatever a workspace file would've handed you. no arguments 🫶
  • --workload <WORKLOAD> — filter by workload, that's it
  • -I, --inventory-dir <DIR> — treat every *.toml in DIR as an inventory, roles unknown. it's giving "idk which is which and I don't care" energy, and it's for the commands that treat inventories alike (show, find, validate, export). wanna be picky? use -i to name files, or a workspace to say which is which
  • -o, --output <OUTPUT> — output file (default: stdout)
  • -C, --directory <DIR> — run as if you'd started in DIR (exactly like git -C): the workspace file, relative inventory paths and outputs all get looked up from there 💅
  • --distros <DISTROS> [default: upstream,fedora,centos,hyperscale] — the default distros list
  • --track <TRACK> [default: upstream] — the default tracking branch
  • -w, --workspace <PATH> — the workspace file (default: ./kondo.toml when it's there) that says which inventory is which — owned, keeps, derived, retired, cull — plus the graph and walk settings, so each subcommand just knows its inputs without you passing -i. Only fills the flags you didn't give on the command line; --no-defaults ignores it entirely 🦋
  • --closure <NAME> — which [[closure]] of the workspace a walk subcommand works on (default: the first one)
  • --prune — remove manifest entries that aren't in the inventory
  • -h, --help — print help

🔎 poi-tracker find

poi-tracker find [-i|--inventory] [-I|--inventory-dir] [-C|--directory]
[-w|--workspace] [--closure] [-h|--help] <NAME>

Where my package at 🔍 — find which inventory file(s) contain a package

  • -i, --inventory <INVENTORY> — exactly these inventory TOML file(s) (repeatable) — the most specific of the three ways to name inventories, and always honoured: it overrides whatever a workspace file would supply
  • -I, --inventory-dir <DIR> — every *.toml in DIR as an inventory, roles unknown — for commands that treat inventories alike (show, find, validate, export). Use -i to pick files, or a workspace to say which is which
  • -C, --directory <DIR> — run as if started in DIR (like git -C): the workspace file, relative inventory paths and outputs are looked up there
  • -w, --workspace <PATH> — workspace file (default: ./kondo.toml when present) naming which inventory is which — owned, keeps, derived, retired, cull — plus the graph and walk settings, so each subcommand knows its inputs without -i. Only fills flags not given on the command line; --no-defaults ignores it ✨
  • --closure <NAME> — which [[closure]] of the workspace a walk subcommand works on (default: the first)
  • -h, --help — print help

<NAME> — Source RPM name to search for 🌸

📥 poi-tracker import

poi-tracker import [-i|--inventory] [-o|--output] [-I|--inventory-dir]
[--private-fields] [-C|--directory] [--workload] [-w|--workspace]
[--closure] [-h|--help] <JSON_FILE>

Glow-up time 💅 — import from the legacy JSON format

  • -i, --inventory <INVENTORY> — exactly these inventory TOML file(s) (repeatable) — the most specific of the three ways to name inventories, and always honoured: it overrides whatever a workspace file would supply
  • -o, --output <OUTPUT> [default: inventory.toml] — output path for the TOML inventory
  • -I, --inventory-dir <DIR> — every *.toml in DIR as an inventory, roles unknown — for commands that treat inventories alike (show, find, validate, export). Use -i to pick files, or a workspace to say which is which
  • --private-fields <FIELD,...> — fields to mark as private (stripped on export) 🙈
  • -C, --directory <DIR> — run as if started in DIR (like git -C): the workspace file, relative inventory paths and outputs are looked up there
  • --workload <WORKLOAD,...> — workload tag(s) to slap on all the imported packages
  • -w, --workspace <PATH> — workspace file (default: ./kondo.toml when present) naming which inventory is which — owned, keeps, derived, retired, cull — plus the graph and walk settings, so each subcommand knows its inputs without -i. Only fills flags not given on the command line; --no-defaults ignores it
  • --closure <NAME> — which [[closure]] of the workspace a walk subcommand works on (default: the first)
  • -h, --help — print help

<JSON_FILE> — path to legacy JSON inventory file 🍓

✂️ poi-tracker intersect

poi-tracker intersect [-i|--inventory] [-I|--inventory-dir]
[-o|--output] [-C|--directory] [--json] [-w|--workspace] [--closure]
[-h|--help] <--with>

The overlap command 🎀 — keep only the inventory packages that are also present in other inventories, optionally merging them into a file

  • -i, --inventory <INVENTORY> — exactly these inventory TOML file(s) (repeatable) — the most specific of the three ways to name inventories, and always honoured: it overrides whatever a workspace file would supply
  • --with <WITH> — inventory file(s) to intersect with: only packages of the main inventory that are also found in one of these survive (repeat the flag once per file)
  • -I, --inventory-dir <DIR> — every *.toml in DIR as an inventory, roles unknown — for commands that treat inventories alike (show, find, validate, export). Use -i to pick files, or a workspace to say which is which
  • -o, --output <OUTPUT> — merge the intersection into this inventory TOML file (it accumulates; existing entries win)
  • -C, --directory <DIR> — run as if started in DIR (like git -C): the workspace file, relative inventory paths and outputs are looked up there
  • --json — output as JSON instead of human-readable
  • -w, --workspace <PATH> — workspace file (default: ./kondo.toml when present) naming which inventory is which — owned, keeps, derived, retired, cull — plus the graph and walk settings, so each subcommand knows its inputs without -i. Only fills flags not given on the command line; --no-defaults ignores it
  • --closure <NAME> — which [[closure]] of the workspace a walk subcommand works on (default: the first)
  • -h, --help — print help

🥰 poi-tracker keep

poi-tracker keep [-i|--inventory] [--into] [-I|--inventory-dir]
[-C|--directory] [--deps] [-w|--workspace] [--closure] [-o|--output]
[-r|--repo] [--from] [--base-repo] [--runtime-only] [--json]
[-v|--verbose] [-h|--help] <--graph> <--owned> <-b|--branch> <PACKAGE>

I'm keeping this 💖 — start keeping packages: walk them against the saved graph (fedrq only gets called for what it lacks), merge, recompute the derived inventory

  • -i, --inventory <INVENTORY> — exactly these inventory TOML file(s) (repeatable) — the most specific of the three ways to name inventories, and always honoured: it overrides whatever a workspace file would supply
  • --into <PATH> — the keep inventory to add them to (default: the first -i)
  • --graph <PATH> — the saved dependency graph to extend (from deps); the walk resolves offline whatever it already knows 🧚
  • -I, --inventory-dir <DIR> — every *.toml in DIR as an inventory, roles unknown — for commands that treat inventories alike (show, find, validate, export). Use -i to pick files, or a workspace to say which is which
  • -C, --directory <DIR> — run as if started in DIR (like git -C): the workspace file, relative inventory paths and outputs are looked up there
  • --owned <PATH> — the inventory of the packages you own — newly reached owned packages become fixpoint roots and derived entries 👑
  • --deps <PATH> — derived inventory to recompute afterwards (optional)
  • -w, --workspace <PATH> — workspace file (default: ./kondo.toml when present) naming which inventory is which — owned, keeps, derived, retired, cull — plus the graph and walk settings, so each subcommand knows its inputs without -i. Only fills flags not given on the command line; --no-defaults ignores it
  • --closure <NAME> — which [[closure]] of the workspace a walk subcommand works on (default: the first)
  • -o, --output <PATH> — closure inventory (the deps -o file) to bring up to date with the graph afterwards (optional)
  • -b, --branch <BRANCH> — fedrq branch (e.g. hs.el9, epel9)
  • -r, --repo <REPO> — fedrq repo class (e.g. stack)
  • --from <FROM> [default: epel] — collect providers from these repo ids (CSV or repeated).

Exact match, no vibes-based fuzzy stuff. The default suits an EPEL walk; for a Fedora walk pass the branch's own repo id, e.g. --from rawhide. 🔥

  • --base-repo <BASE_REPO> [default: fedrq-centos-stream-] — base-distro repo id prefix(es); their providers end the walk.

The default treats CentOS Stream as the given beneath an EPEL stack. A Fedora walk has no base distro — the default then never matches, and everything resolves within --from's repos, which is exactly what you want. ✨

  • --runtime-only — walk runtime dependencies only, without seeding the roots' BuildRequires
  • --json — output as JSON instead of human-readable
  • -v, --verbose — print progress to stderr
  • -h, --help — print help (see a summary with '-h')

<PACKAGE> — packages to start keeping 🌟

🧹 poi-tracker kondo

poi-tracker kondo [-i|--inventory] [--pattern] [-I|--inventory-dir]
[--start-from] [-C|--directory] [--end-with] [-w|--workspace]
[--closure] [--explain-into] [-y|--yes] [--refresh-acls] [--reason]
[-o|--output] [--json] [-v|--verbose] [-h|--help] <--essential> <--user>

The triage era 🧹 — deal with the packages no essential inventory needs: keep them as a cull candidate, file them into an inventory, or just drop them

  • -i, --inventory <INVENTORY> — exactly these inventory TOML file(s) (repeatable) — the most specific of the three ways to name inventories, and always honoured: it overrides whatever a workspace file would supply
  • --pattern <GLOB,...> — only process packages matching this glob (e.g. rust-*; a bare name matches exactly). Comma-separated or repeated; default: all packages 🌈
  • -I, --inventory-dir <DIR> — every *.toml in DIR counts as an inventory, but their roles are unknown 👀 — perfect for commands that treat all inventories the same (show, find, validate, export). Wanna pick specific files? use -i. Wanna say which inventory is which? use a workspace 💅
  • --start-from <NAME> — resume from this package onwards, inclusive — following the inventory's iteration order bestie
  • -C, --directory <DIR> — run as if you'd started in DIR, exactly like git -C does: the workspace file, the relative inventory paths and the outputs all get looked up there ✨
  • --end-with <NAME> — stop after this package (inclusive). Pair it with --start-from and boom, you've bounded a sub-range 🎀
  • --essential <ESSENTIAL> — essential inventory file(s): anything found in any of these is never ever a cull candidate (repeat the flag once per file, no shortcuts)
  • -w, --workspace <PATH> — the workspace file (defaults to ./kondo.toml when it's there) that says which inventory is which — owned, keeps, derived, retired, cull — plus all the graph and walk settings, so every subcommand just knows its inputs without you juggling -i. It only fills in flags you didn't already pass on the command line; --no-defaults makes it mind its business 💅
  • --closure <NAME> — which [[closure]] of the workspace a walk subcommand works on (default: the first one)
  • --user <USER> — the dist-git username whose access level routes each action 👑
  • --explain-into <PATH> — default inventory for explain: hit Enter at the explanation prompt and the package gets filed here
  • -y, --yes — keep every candidate, no prompting, no thoughts, just vibes
  • --refresh-acls — ignore the day-fresh ACL cache and re-look-up every single level from scratch 😮‍💨
  • --reason <REASON> — the reason that gets recorded in the -o cull file for packages culled this run (the access level is always appended btw). A note typed at the prompt as c <note> overrides it, per package 💖
  • -o, --output <OUTPUT> — merge the culled set into this inventory TOML file (it accumulates across passes, so nothing gets lost)
  • --json — output as JSON instead of the human-readable stuff 🦋
  • -v, --verbose — print progress to stderr
  • -h, --help — print help

🌸 poi-tracker prune-retired

poi-tracker prune-retired [--branch] [-i|--inventory]
[-I|--inventory-dir] [--pattern] [-C|--directory] [--start-from]
[--end-with] [-w|--workspace] [--closure] [-j|--jobs] [--dry-run]
[--remove] [-y|--yes] [-v|--verbose] [-h|--help]

Mark (or remove, your call) packages that aren't carried on any active branch anymore — so either the dist-git project is gone, or it's retired literally everywhere 🪦

  • --branch <BRANCH,...> — the active branch(es) to check against (CSV or repeated; e.g. rawhide,f44,epel9). Default: queried from Bodhi's active releases, plus rawhide ✨
  • -i, --inventory <INVENTORY> — exactly these inventory TOML file(s) (repeatable) — the most specific of the three ways to name inventories, and always honoured: it overrides whatever a workspace file would try to supply 👑
  • -I, --inventory-dir <DIR> — every *.toml in DIR as an inventory, roles unknown — for commands that treat inventories alike (show, find, validate, export). Use -i to pick files, or a workspace to say which is which
  • --pattern <GLOB,...> — only process packages matching this glob (e.g. rust-*; a bare name matches exactly). Comma-separated or repeated; default: all packages, no filter no problem 💅
  • -C, --directory <DIR> — run as if you started in DIR (like git -C): the workspace file, relative inventory paths and outputs are looked up there
  • --start-from <NAME> — resume from this package onwards (inclusive), in the inventory's iteration order
  • --end-with <NAME> — stop after this package (inclusive). Combine with --start-from to bound a sub-range 🎀
  • -w, --workspace <PATH> — workspace file (default: ./kondo.toml when present) naming which inventory is which — owned, keeps, derived, retired, cull — plus the graph and walk settings, so each subcommand knows its inputs without -i. Only fills flags not given on the command line; --no-defaults ignores it
  • --closure <NAME> — which [[closure]] of the workspace a walk subcommand works on (default: the first)
  • -j, --jobs <JOBS> [default: 8] — parallel dist-git queries, go faster bestie 🏃‍♀️
  • --dry-run — preview without modifying the inventory (no cap, we love a safe lil peek)
  • --remove — delete matched packages from the inventory instead of marking them unshipped (which is the default — marking survives re-syncs and lets triage-retired keep closing bugs, so like, think before you yeet 🫣)
  • -y, --yes — skip the confirmation prompt
  • -v, --verbose — print progress to stderr
  • -h, --help — print help

💜 poi-tracker reconcile

poi-tracker reconcile [-i|--inventory] [--into] [-I|--inventory-dir]
[-y|--yes] [-C|--directory] [--refresh-acls] [--dry-run]
[-w|--workspace] [--closure] [--json] [-v|--verbose] [-h|--help]

Bring the workspace's inventories up to date with its keeps: walk the new keeps, recompute the derived inventories, ask the decisions a program can't make on its own, and then triage whatever nothing justifies 🔥

  • -i, --inventory <INVENTORY> — exactly these inventory TOML file(s) (repeatable) — the most specific of the three ways to name inventories, and always honoured: it overrides whatever a workspace file would supply
  • --into <PATH> — essential inventory that promoted packages are filed into (default: the closure's first keeps inventory)
  • -I, --inventory-dir <DIR> — every *.toml in DIR as an inventory, roles unknown — for commands that treat inventories alike (show, find, validate, export). Use -i to pick files, or a workspace to say which is which
  • -y, --yes — take every default without asking (ride, keep essential), and leave the triage candidates as cull candidates 😴
  • -C, --directory <DIR> — run as if started in DIR (like git -C): the workspace file, relative inventory paths and outputs are looked up there
  • --refresh-acls — ignore the day-fresh ACL cache in the triage
  • --dry-run — compute and report only: write no file, walk nothing, ask nothing (new keeps get listed instead of walked) 🧚
  • -w, --workspace <PATH> — workspace file (default: ./kondo.toml when present) naming which inventory is which — owned, keeps, derived, retired, cull — plus the graph and walk settings, so each subcommand knows its inputs without -i. Only fills flags not given on the command line; --no-defaults ignores it
  • --closure <NAME> — which [[closure]] of the workspace a walk subcommand works on (default: the first)
  • --json — report as JSON; asks and triages nothing (files are still written unless --dry-run ✍️)
  • -v, --verbose — print progress to stderr
  • -h, --help — print help

🦋 poi-tracker remove

poi-tracker remove [-i|--inventory] [--rpm] [-I|--inventory-dir]
[-C|--directory] [-w|--workspace] [--closure] [-h|--help] <NAME>

Remove a package from the inventory, bye bestie 👋

  • -i, --inventory <INVENTORY> — exactly these inventory TOML file(s) (repeatable) — the most specific of the three ways to name inventories, and always honoured: it overrides whatever a workspace file would supply
  • --rpm <RPM> — remove specific binary RPM(s) instead of the whole package (surgical, love that)
  • -I, --inventory-dir <DIR> — every *.toml in DIR as an inventory, roles unknown — for commands that treat inventories alike (show, find, validate, export). Use -i to pick files, or a workspace to say which is which
  • -C, --directory <DIR> — run as if started in DIR (like git -C): the workspace file, relative inventory paths and outputs are looked up there
  • -w, --workspace <PATH> — workspace file (default: ./kondo.toml when present) naming which inventory is which — owned, keeps, derived, retired, cull — plus the graph and walk settings, so each subcommand knows its inputs without -i. Only fills flags not given on the command line; --no-defaults ignores it
  • --closure <NAME> — which [[closure]] of the workspace a walk subcommand works on (default: the first)
  • -h, --help — print help
  • <NAME> — source RPM name to remove

🌈 poi-tracker semver-audit

poi-tracker semver-audit [-i|--inventory] [--pattern]
[-I|--inventory-dir] [--start-from] [-C|--directory] [--end-with]
[--batch] [-w|--workspace] [--closure] [--non-breaking] [--json]
[-v|--verbose] [-h|--help]

Audit pending upstream updates by semver impact, flagging which ones are non-breaking, which are breaking, and which need a human to review 🫡

  • -i, --inventory <INVENTORY> — exactly these inventory TOML file(s) (repeatable) — the most specific of the three ways to name inventories, and always honoured: it overrides whatever a workspace file would supply
  • --pattern <GLOB,...> — only process packages matching this glob (e.g. rust-*; a bare name matches exactly). Comma-separated or repeated; default: all packages
  • -I, --inventory-dir <DIR> — every *.toml in DIR as an inventory, roles unknown — for commands that treat inventories alike (show, find, validate, export). Use -i to pick files, or a workspace to say which is which
  • --start-from <NAME> — resume from this package onwards (inclusive), in the inventory's iteration order
  • -C, --directory <DIR> — run as if started in DIR (like git -C): the workspace file, relative inventory paths and outputs are looked up there
  • --end-with <NAME> — stop after this package (inclusive). Combine with --start-from to bound a sub-range
  • --batch [<EMAIL>] — batch mode: one Bugzilla query for bugs assigned to or CC'ing EMAIL (default: the configured email), then matched against the inventory locally. Much faster on a large inventory — but heads up, it misses bugs where EMAIL is neither assignee nor CC'd 💀
  • -w, --workspace <PATH> — workspace file (default: ./kondo.toml when present) naming which inventory is which — owned, keeps, derived, retired, cull — plus the graph and walk settings, so each subcommand knows its inputs without -i. Only fills flags not given on the command line; --no-defaults ignores it
  • --closure <NAME> — which [[closure]] of the workspace a walk subcommand works on (default: the first)
  • --non-breaking — show only non-breaking updates 🎀
  • --json — output as JSON instead of human-readable text
  • -v, --verbose — print progress to stderr
  • -h, --help — print help

🎀 poi-tracker show 🎀

poi-tracker show [-i|--inventory] [--workload] [-I|--inventory-dir]
[--json] [-C|--directory] [-w|--workspace] [--closure] [-h|--help]

Bestie, this one just shows you what's in your inventory. No edits, no drama, just receipts. ✨

  • -i, --inventory INVENTORY — literally exactly these inventory TOML file(s) (you can repeat it). It's the most specific of the three ways to name inventories and it is always honoured — it overrides whatever a workspace file would try to hand you. 👑
  • --workload WORKLOAD — filter by workload
  • -I, --inventory-dir DIR — treat every *.toml in DIR as an inventory, though roles stay unknown 🫥 — this is for the commands that treat inventories alike (show, find, validate, export). Want to pick exact files? Use -i. Want to say which one is which? Use a workspace.
  • --json — output as JSON instead of human-readable (for when your eyes are tired and your scripts are hungry 🍓)
  • -C, --directory DIR — run as if you'd started in DIR, exactly like git -C: the workspace file, relative inventory paths and outputs all get looked up there
  • -w, --workspace PATH — the workspace file (default: ./kondo.toml when it's present) that names which inventory is which — owned, keeps, derived, retired, cull — plus the graph and walk settings, so every subcommand knows its inputs without you passing -i. Heads up: it only fills in flags you didn't give on the command line, and --no-defaults ignores it entirely 💅
  • --closure NAME — which [[closure]] of the workspace a walk subcommand works on (default: the first)
  • -h, --help — print help

🌈 poi-tracker sync-distgit 🌈

poi-tracker sync-distgit [-i|--inventory] [-I|--inventory-dir]
[-C|--directory] [-o|--output] [--fast] [-w|--workspace] [--closure]
[--no-groups] [--include-group] [--exclude-group] [--exclude]
[--pattern] [--start-pattern] [--end-pattern] [--auto-prefix]
[--no-auto-prefix] [--prune] [--mark-unshipped] [-j|--jobs] [--per-page]
[--workload] [--name] [-h|--help] <--user|--group>

Sync your inventory straight from Fedora dist-git (Pagure) access. 🐧 It's giving plumbing and honestly? We love her.

  • -i, --inventory INVENTORY — exactly these inventory TOML file(s) (repeatable), the most specific of the three ways to name inventories and always honoured: it overrides whatever a workspace file would supply. 👑
  • --user USER — import packages for this dist-git user
  • --group GROUP — import packages for this dist-git group
  • -I, --inventory-dir DIR — every *.toml in DIR as an inventory, roles unknown — for the commands that treat inventories alike (show, find, validate, export). Use -i to pick files, or a workspace to say which is which.
  • -C, --directory DIR — run as if started in DIR (like git -C): the workspace file, relative inventory paths and outputs are looked up there
  • -o, --output OUTPUT [default: inventory.toml] — the output TOML file 📝
  • --fast — one owner-alias request instead of a prefix scan. ⚠️ Direct owner/admin/commit only: collaborator/ticket grants get missed (and removed under --prune). Also implies --no-groups.
  • -w, --workspace PATH — workspace file (default: ./kondo.toml when present) naming which inventory is which — owned, keeps, derived, retired, cull — plus the graph and walk settings, so each subcommand knows its inputs without -i. Only fills flags not given on the command line; --no-defaults ignores it.
  • --closure NAME — which [[closure]] of the workspace a walk subcommand works on (default: the first)
  • --no-groups — exclude group-only access 🙅‍♀️
  • --include-group GROUP,... — keep only these groups (CSV or repeated)
  • --exclude-group GROUP,... — drop these groups (CSV or repeated)
  • --exclude GLOB,... — exclude packages by glob (CSV or repeated)
  • --pattern PATTERN — name pattern for a single patterned query
  • --start-pattern PREFIX — start the prefix scan at this prefix
  • --end-pattern PREFIX — stop the prefix scan before this prefix
  • --auto-prefix — query by a-z/0-9 prefix (this is the --user default ✅)
  • --no-auto-prefix — single query; heads up, this may 504 for a --user sync 😭
  • --prune — remove packages no longer in dist-git results ✂️
  • --mark-unshipped — mark packages added by this sync that are already retired everywhere (like prune-retired)
  • -j, --jobs JOBS [default: 8] — parallel dist-git queries for --mark-unshipped
  • --per-page PER_PAGE [default: 100] — Pagure API page size
  • --workload WORKLOAD,... — workload tags (CSV or repeated)
  • --name NAME — inventory name (default: user/group)
  • -h, --help — print help

🦋 poi-tracker sync-gitlab 🦋

poi-tracker sync-gitlab [-i|--inventory] [-I|--inventory-dir]
[-C|--directory] [-o|--output] [--exclude] [-w|--workspace] [--closure]
[--prune] [--workload] [--mark-unshipped] [--centos-release] [--name]
[-h|--help] <--url|--preset>

Sync inventory from a GitLab RPM group 🦊 — yes, the fox one.

  • -i, --inventory INVENTORY — exactly these inventory TOML file(s) (repeatable), the most specific of the three ways to name inventories, always honoured: it overrides whatever a workspace file would supply. 👑
  • --url URL — GitLab group URL
  • -I, --inventory-dir DIR — every *.toml in DIR as an inventory, roles unknown — for commands that treat inventories alike (show, find, validate, export). Use -i to pick files, or a workspace to say which is which.
  • --preset PRESET — preset: hyperscale, proposed-updates, centos-stream
  • -C, --directory DIR — run as if started in DIR (like git -C): the workspace file, relative inventory paths and outputs are looked up there
  • -o, --output OUTPUT [default: inventory.toml] — output TOML file 📝
  • --exclude GLOB,... — exclude packages by glob (CSV or repeated)
  • -w, --workspace PATH — workspace file (default: ./kondo.toml when present) naming which inventory is which — owned, keeps, derived, retired, cull — plus the graph and walk settings, so each subcommand knows its inputs without -i. Only fills flags not given on the command line; --no-defaults ignores it.
  • --closure NAME — which [[closure]] of the workspace a walk subcommand works on (default: the first)
  • --prune — remove packages no longer in GitLab results ✂️
  • --workload WORKLOAD,... — workload tags (CSV or repeated)
  • --mark-unshipped — mark archived projects with no released CBS build as unshipped (Hyperscale: RHEL or Stream; Proposed Updates: Stream only)
  • --centos-release REL,... [default: 9,10] — CentOS releases to count as currently shipped (CSV)
  • --name NAME — inventory name (default: derived from group)
  • -h, --help — print help

💜 poi-tracker sync-rpmfusion 💜

poi-tracker sync-rpmfusion [-i|--inventory] [-I|--inventory-dir]
[-o|--output] [-C|--directory] [--repo] [--prune] [-w|--workspace]
[--closure] [--name] [-h|--help] <-r|--release>

Sync inventory from RPM Fusion's repositories, one workload per release. 🎀

  • -i, --inventory INVENTORY — exactly these inventory TOML file(s) (repeatable), the most specific of the three ways to name inventories and always honoured: it overrides whatever a workspace file would supply. 👑
  • -r, --release REL,... — releases to scan (CSV): f43, f44, el10. Each one becomes a workload, so the inventory can answer per release 🗂️
  • -I, --inventory-dir DIR — every *.toml in DIR as an inventory, roles unknown — for commands that treat inventories alike (show, find, validate, export). Use -i to pick files, or a workspace to say which is which.
  • -o, --output OUTPUT [default: inventory.toml] — output TOML file 📝
  • -C, --directory DIR — run as if started in DIR (like git -C): the workspace file, relative inventory paths and outputs are looked up there
  • --repo CLASS — fedrq repo class. The default covers free and nonfree together, which is exactly what "does RPM Fusion ship this?" is asking 💅
  • --prune — remove packages RPM Fusion ships for no release listed in the inventory. Bestie, important: scanning a subset never prunes what another release still ships. ✂️
  • -w, --workspace PATH — workspace file (default: ./kondo.toml when present) naming which inventory is which — owned, keeps, derived, retired, cull — plus the graph and walk settings, so each subcommand knows its inputs without -i. Only fills flags not given on the command line; --no-defaults ignores it.
  • --closure NAME — which [[closure]] of the workspace a walk subcommand works on (default: the first)
  • --name NAME — inventory name (default: rpmfusion)
  • -h, --help — print help

🧚 poi-tracker triage-retired 🧚

poi-tracker triage-retired [--branch] [-i|--inventory]
[-I|--inventory-dir] [--pattern] [-C|--directory] [--start-from]
[--end-with] [-w|--workspace] [--batch] [--closure] [--all-reporters]
[--mark] [--api-key] [--claim] [--dry-run] [-y|--yes] [-v|--verbose]
[-h|--help]

Close open release-monitoring bugs as CANTFIX for any inventoried package that is retired on a dist-git branch. 💀 This one's the bug-closer, and she is thorough.

  • --branch BRANCH,... [default: rawhide] — dist-git branch(es) to check retirement against (CSV or repeated; e.g. rawhide, epel10, f43). Each branch scopes its own Bugzilla search — a rawhide retirement closes the Fedora/rawhide bug, an epel9 retirement closes the Fedora EPEL/epel9 bug. A package retired on one branch but live on another only has bugs closed where it's dead. 💅
  • -i, --inventory INVENTORY — exactly these inventory TOML file(s) (repeatable), the most specific of the three ways to name inventories and always honoured: it overrides whatever a workspace file would supply. 👑
  • -I, --inventory-dir DIR — every *.toml in DIR as an inventory, roles unknown — for commands that treat inventories alike (show, find, validate, export). Use -i to pick files, or a workspace to say which is which.
  • --pattern GLOB,... — only process packages matching this glob (e.g. rust-*; a bare name matches exactly). Comma-separated or repeated; default: all packages 🔍
  • -C, --directory DIR — run as if started in DIR (like git -C): the workspace file, relative inventory paths and outputs are looked up there
  • --start-from NAME — resume from this package onwards (inclusive), in the inventory's iteration order
  • --end-with NAME — stop after this package (inclusive). Combine it with --start-from to bound a sub-range 🫶
  • -w, --workspace <PATH> — the workspace file, bestie 💅 defaults to ./kondo.toml whenever that's hanging around. It's the receipts file that says which inventory is which — owned, keeps, derived, retired, cull — plus all your graph and walk settings, so every subcommand just knows its inputs without you typing -i. It only tops up flags you didn't already give on the command line, and --no-defaults straight-up ignores it, periodt.
  • --batch [<EMAIL>] — batch mode, a.k.a. the speedrun ✨ One single Bugzilla query for bugs assigned to or CC'ing EMAIL (default: the email you configured), then it gets matched against the inventory locally. Lowkey so much faster on a big inventory — but heads up, it misses any bug where EMAIL is neither assignee nor CC'd. 💀
  • --closure <NAME> — which [[closure]] of the workspace a walk subcommand works on (default: the first one).
  • --all-reporters — closes ALL the open bugs on retired branches, not just release-monitoring (Anitya) bugs. ⚠️ Use with care, fr fr — this closes human-filed bugs (CVEs, FTBFS, etc.) too.
  • --mark — records results in the inventory's retired_on markers (adds and removes; needs a single -i file).
  • --api-key <API_KEY> — your Bugzilla API key (or just set the BUGZILLA_API_KEY env var, or run poi-tracker config). May also be specified with the BUGZILLA_API_KEY environment variable.
  • --claim — also sets assigned_to on every closed bug to the Bugzilla email you set via poi-tracker config. Interactive mode prompts you about it; with -y this flag is the only way to claim.
  • --dry-run — preview your closures without applying them 👀 no take-backs needed.
  • -y, --yes — skips the confirmation prompt.
  • -v, --verbose — prints progress to stderr.
  • -h, --help — prints help.

poi-tracker triage-updates 🌸

poi-tracker triage-updates [-i|--inventory] [--pattern]
[-I|--inventory-dir] [--start-from] [-C|--directory] [--end-with]
[--batch] [-w|--workspace] [--close-stale] [--closure] [--skip-stale]
[--api-key] [--claim] [--dry-run] [-y|--yes] [-v|--verbose] [-h|--help]

Triage the open release-monitoring bugs for your inventoried packages by bumping their Bugzilla priority so it matches the inventory. ✨

  • -i, --inventory <INVENTORY> — exactly these inventory TOML file(s), repeatable. This is the most specific of the three ways to name inventories, and it is always honoured — it overrides whatever a workspace file would've supplied. 💅
  • --pattern <GLOB,...> — only process packages matching this glob (like rust-*; a bare name matches exactly). Comma-separated or repeated; default is all the packages.
  • -I, --inventory-dir <DIR> — every *.toml in DIR as an inventory, roles unknown. For commands that treat inventories alike (show, find, validate, export). Use -i to pick files, or a workspace to say which is which.
  • --start-from <NAME> — resume from this package onwards (inclusive), in the inventory's iteration order.
  • -C, --directory <DIR> — run as if you'd started in DIR (like git -C): the workspace file, relative inventory paths and outputs all get looked up there.
  • --end-with <NAME> — stop after this package (inclusive). Combine with --start-from to bound a sub-range. 🎯
  • --batch [<EMAIL>] — batch mode: one Bugzilla query for bugs assigned to or CC'ing EMAIL (default: the configured email), matched against the inventory locally. Much faster on a large inventory, but it misses bugs where EMAIL is neither assignee nor CC'd.
  • -w, --workspace <PATH> — workspace file (default: ./kondo.toml when present) naming which inventory is which — owned, keeps, derived, retired, cull — plus the graph and walk settings, so each subcommand knows its inputs without -i. Only fills flags not given on the command line; --no-defaults ignores it.
  • --close-stale — close partially-addressed bugs without asking.
  • --closure <NAME> — which [[closure]] of the workspace a walk subcommand works on (default: the first).
  • --skip-stale — skip the Bodhi check for already-built updates.
  • --api-key <API_KEY> — Bugzilla API key (or set BUGZILLA_API_KEY env var, or run poi-tracker config). May also be specified with the BUGZILLA_API_KEY environment variable.
  • --claim — also set assigned_to on each closed bug to the Bugzilla email set via poi-tracker config. Interactive mode prompts; with -y this flag is the only way to claim.
  • --dry-run — preview updates without applying them. 👀
  • -y, --yes — skip the confirmation prompt.
  • -v, --verbose — print progress to stderr.
  • -h, --help — print help.

poi-tracker unkeep 🎀

poi-tracker unkeep [-i|--inventory] [--deps] [-I|--inventory-dir]
[--apply] [-C|--directory] [--json] [-w|--workspace] [--closure]
[-h|--help] <--graph> <PACKAGE>

Stop keeping packages: over a saved dependency graph, report what the removal frees, and optionally edit the inventories. It's giving "let it go" energy 🦋

  • --graph <PATH> — dependency graph JSON from a deps --graph run.
  • -i, --inventory <INVENTORY> — exactly these inventory TOML file(s) (repeatable) — the most specific of the three ways to name inventories, and always honoured: it overrides whatever a workspace file would supply.
  • --deps <PATH> — derived dependency inventories (a deps output merged by intersect, say); freed packages leave these with --apply.
  • -I, --inventory-dir <DIR> — every *.toml in DIR as an inventory, roles unknown — for commands that treat inventories alike (show, find, validate, export). Use -i to pick files, or a workspace to say which is which.
  • --apply — edit the inventories; without it, report only. 🫶
  • -C, --directory <DIR> — run as if started in DIR (like git -C): the workspace file, relative inventory paths and outputs are looked up there.
  • --json — output machine-readable JSON.
  • -w, --workspace <PATH> — workspace file (default: ./kondo.toml when present) naming which inventory is which — owned, keeps, derived, retired, cull — plus the graph and walk settings, so each subcommand knows its inputs without -i. Only fills flags not given on the command line; --no-defaults ignores it.
  • --closure <NAME> — which [[closure]] of the workspace a walk subcommand works on (default: the first).
  • -h, --help — print help.
  • <PACKAGE> — packages to stop keeping.

poi-tracker validate 💜

poi-tracker validate [-i|--inventory] [-I|--inventory-dir]
[-C|--directory] [-w|--workspace] [--closure] [-h|--help]

Validate inventory consistency. The vibe check for your TOMLs, basically. ✅

  • -i, --inventory <INVENTORY> — exactly these inventory TOML file(s) (repeatable) — the most specific of the three ways to name inventories, and always honoured: it overrides whatever a workspace file would supply.
  • -I, --inventory-dir <DIR> — every *.toml in DIR as an inventory, roles unknown — for commands that treat inventories alike (show, find, validate, export). Use -i to pick files, or a workspace to say which is which.
  • -C, --directory <DIR> — run as if started in DIR (like git -C): the workspace file, relative inventory paths and outputs are looked up there.
  • -w, --workspace <PATH> — workspace file (default: ./kondo.toml when present) naming which inventory is which — owned, keeps, derived, retired, cull — plus the graph and walk settings, so each subcommand knows its inputs without -i. Only fills flags not given on the command line; --no-defaults ignores it.
  • --closure <NAME> — which [[closure]] of the workspace a walk subcommand works on (default: the first).
  • -h, --help — print help.
💖 And that's a wrap on the whole page, bestie!! This gorgeous manual is brought to you by sandogasa, sitting pretty at version 0.27.0, dated 2026-10-21. Go forth and be iconic out there 💅✨👑
📦 where this page comes from
  • fedora 43: sandogasa 0.27.0-2.fc43 · (Apache-2.0 OR MIT) AND LicenseRef-Fedora-Public-Domain AND Unicode-3.0 AND Apache-2.0 AND ISC AND MIT AND (Apache-2.0 OR BSL-1.0) AND (Apache-2.0 OR ISC OR MIT) AND (Apache-2.0 WITH LLVM-exception OR Apache-2.0 OR MIT) AND BSD-3-Clause AND MPL-2.0 AND (Unlicense OR MIT) AND Zlib
  • fedora 44: sandogasa 0.27.0-2.fc44 · (Apache-2.0 OR MIT) AND LicenseRef-Fedora-Public-Domain AND Unicode-3.0 AND Apache-2.0 AND ISC AND MIT AND (Apache-2.0 OR BSL-1.0) AND (Apache-2.0 OR ISC OR MIT) AND (Apache-2.0 WITH LLVM-exception OR Apache-2.0 OR MIT) AND BSD-3-Clause AND MPL-2.0 AND (Unlicense OR MIT) AND Zlib
  • 💖 girlified by deepseek-ai/DeepSeek-V4.1-Flash on : a language model's rewrite of the original, under its terms