TKN-HUB-SEARCH(1)

📦 version 0.46.2, in nixos 26.05, nixpkgs unstable

okay so bestie, welcome to tkn-hub-search(1) — yes that's section 1 of the manual, we're fancy like that. this is the page that teaches you how to go shopping in the Tekton Hub, except instead of clothes it's resources and instead of vibes it's filters. slay.

✨ NAME ✨

tkn-hub-search — search a resource by a combination of name, kind, categories, platforms, and tags. like a vibe check but for artifacts 🎀

🦋 SYNOPSIS 🦋

tkn hub search

that's it. that's the whole thing. short and iconic, no cap ✨

💖 DESCRIPTION 💖

the way this literally just searches a resource by a combination of name, kind, categories, platforms, and tags. mix and match your fave filters, it's giving build-your-own-search. lowkey the most useful thing ever 🫶

👑 OPTIONS 👑

  • --categories=[] — takes a comma separated list of categories. pick your categories, bestie, go off 🍓
  • -h, --help[=false] — help for search. the classic. when in doubt, ask for help 💅
  • --kinds=[] — accepts a comma separated list of kinds. so you can be like "only this kind of resource pls" 🤌
  • -l, --limit=0 — max number of resources to fetch. 0 means no cap on your ambitions (well, that's the default value, bestie — it's 0) 🔥
  • --match="contains" — accept type of search. 'exact' or 'contains'. defaults to "contains", so it's chill and flexible by default 🌈
  • -o, --output="table" — accepts output format: [table, json, wide]. defaults to "table" because we love a tidy little grid ✨
  • --platforms=[] — accepts a comma separated list of platforms. filter by platform, go nuts 🦋
  • --tags=[] — accepts a comma separated list of tags. tag-based searching is sooo underrated ngl 🏷️

🧚 OPTIONS INHERITED FROM PARENT COMMANDS 🧚

these ones you get for free from the parent command, like a little gift from the group chat 💜

  • --api-server="" — the Hub API Server URL. defaults to https://api.hub.tekton.dev for 'tekton' type, and defaults to https://artifacthub.io for 'artifact' type. and listen — the URL can also be defined in a file $HOME/.tekton/hub-config with a variable TEKTON_HUB_API_SERVER/ARTIFACT_HUB_API_SERVER. so you can set it once and forget it, main character energy ⭐
  • --type="tekton" — the type of Hub from where to pull the resource. either 'artifact' or 'tekton'. defaults to "tekton" 🎀

🍓 EXAMPLE 🍓

search a resource of name 'foo':

tkn hub search foo

or

search resources using tag 'cli':

tkn hub search --tags cli

see? easy. ate and left no crumbs 😭

🌸 SEE ALSO 🌸

tkn-hub(1) — the parent, the icon, the moment 👑

fr fr that's the whole page. go search something cute 💅

auto generated by spf13/cobra — yeah that's the source/version footnote, we don't make the rules, we just make them adorable 🫶💖

made with love and also cobra, dated like all good manpages are — and that's the teaaa 🎀✨

📦 where this page comes from