GIT-PKGS(1)

📦 version 0.21.0, in nixpkgs unstable

💅 GIT-PKGS(1) — the git-pkgs manual, bestie edition 🎀

okay so real talk, this is one page out of the whole Git Pkgs Manual, and it's about importing notes. yes, notes. the little annotation besties. let's get into it ✨

✨ NAME ✨

git-pkgs-notes-import — literally the command that imports your notes from a YAML or JSON file 🫶

🌸 SYNOPSIS 🌸

git-pkgs notes import  [flags]

that's it. that's the whole vibe. git-pkgs, subcommand notes, subcommand import, then whatever [flags] you feel like adding 💅

🦋 DESCRIPTION 🦋

So what does it do? It imports notes from a YAML or JSON file. both formats are invited to the party, no gatekeeping 💖

And here's the important little detail: imported notes are upserted by purl+namespace. That's the matching key, no cap — purl plus namespace, together. (upsert = update if it's already there, insert if it's not. slay.)

🔥 OPTIONS 🔥

  • -h, --help[=false] — shows help for import. the classic. always there for you 🥺
  • --namespace="" — the default namespace for imported notes. empty string by default, so set it if you want it set ✨
  • --origin="git-pkgs" — the tool or system that created the imported notes. defaults to "git-pkgs" because, well, look around 💅

👑 OPTIONS INHERITED FROM PARENT COMMANDS 👑

these ones aren't even yours, they're handed down from the parent commands. nepo babies but make it flags 💀

  • --color="auto" — when to colorize output. your choices are auto, always, never. default is auto, she decides for you 🌈
  • --include-submodules[=false] — include git submodules when scanning for manifests. off by default (false), so if you've got submodules and you're like "where are they" — yeah, this one 🫶
  • -p, --pager[=false] — use pager for output. default false. turn it on when the output is long enough to scroll, iykyk 📜
  • -q, --quiet[=false] — suppress non-essential output. default false. the shy girlie option, use it when you want silence 🤫

🧚 SEE ALSO 🧚

  • git-pkgs-notes(1) — the parent situation, go read it, it's giving main character energy 👑

💀 HISTORY 💀

  • 28-Oct-2026 — auto generated by spf13/cobra. not a human, a robot did this. iconic of it honestly 🤖✨
heads up bestie: this page is generated, so don't come for me if the flags change — the robot writes it, the robot updates it 🙈

and that's the whole page! 💖 this came from the git-pkgs manual, Oct 2026 edition, and omg it's been a whole journey — now go import some notes, bestie, you've got this 🎀⭐🦋💜

📦 where this page comes from