YB-FETCH(1)

πŸ“¦ version 0.5.2, in nixos 26.05, nixpkgs unstable

πŸ’– YB-FETCH(1) β€” the one where you get your blobs back πŸ’–

okay so real talk, this is a page from the User Commands manual and it's literally all about the fetch command, and bestie, it is so good. buckle up πŸŽ€


✨ NAME ✨

fetch β€” retrieve one or more blobs 🫢


🌸 SYNOPSIS 🌸

fetch [-p|--stdout] [-o|--output] [-O|--output-dir] [-h|--help]
<PATTERNS>

πŸ¦‹ DESCRIPTION πŸ¦‹

okay so here's the vibe: fetch retrieves one or more blobs from the YubiKey. no cap, that's the whole job. πŸ‘‘

You can pass it names and glob patterns β€” both are accepted, which is highkey iconic of it. every blob that matches gets written to a file in the current directory (or in OUTPUT_DIR if you set one), and the filename is the blob name. slay. πŸ’…

Also important, and this is the part where you listen: use --stdout or --output when exactly one blob is selected and you need direct control over where the thing goes. periodt. ✨


πŸŽ€ OPTIONS πŸŽ€

  • -p, --stdout β€” writes the blob content straight to stdout. only valid when exactly one blob matches, so don't get cute with it πŸ™ˆ
  • -o, --output <OUTPUT> β€” writes the output to this file. again, only valid when exactly one blob matches πŸ’–
  • -O, --output-dir <OUTPUT_DIR> β€” writes the fetched files into this directory. default is the current directory πŸ—‚οΈ
  • -h, --help β€” prints help. classic. helpful. we love her 🫢
  • <PATTERNS> β€” the blob name(s) or glob patterns you want to retrieve. this is the main character of the command fr fr ⭐

🌈 EXAMPLES 🌈

Fetch a single blob to the current directory:

yb fetch secret.key

Fetch to a specific file:

yb fetch -o /tmp/key.pem mykey

Print to stdout (pipe-friendly):

yb fetch --stdout mypassword | xclip

Fetch all blobs matching a glob into a directory:

yb fetch -O ./restore '*.key'

like, the glob one? '*.key' with the quotes? chef's kiss πŸ”₯


πŸ’œ SEE ALSO πŸ’œ

yb(1), yb-store(1), yb-list(1) β€” go read those too, they're friends of this page 🧚


ngl, the "only valid when exactly one blob matches" thing shows up twice in the options and it's not a suggestion. if you've got multiple blobs matching and you point --stdout at them, that's a you problem 😭

and that's the page!! 🌸 it's from yb, dated 2026-03, and yes it's technically YB-FETCH(1) but we're on a first-name basis now. mwah πŸ’–πŸ“πŸ‘‘

πŸ“¦ where this page comes from