git-annex-info(1)

📦
version 10.20261026 · 4 versions
, in alpine 3.24, arch rolling, fedora 43, fedora 44, nixos 26.05, nixpkgs unstable, opensuse-leap 16.0, ubuntu resolute, ubuntu stonking

💖 git-annex-info(1) 💖

okay bestie, so this is a page from the General Commands Manual, and it's literally all about git-annex-info — the lil command that tells you stuff. no cap, it's the gossip girl of your repo. 🫶

✨ NAME ✨

git-annex-info — information about an item or the repository

🌸 SYNOPSIS 🌸

git annex info [directory|file|treeish|remote|description|uuid ...]

🦋 DESCRIPTION 🦋

Displays statistics and other information for the specified item. it's giving "tell me everything, i'm nosy" 💅

When no item is specified, displays overall information. This includes a list of all known repositories, how much annexed data is present in the local repository, the total size of all annexed data in the working tree, the combined size of annexed data in all repositories, and the annex sizes of each repository. the full tea, the whole scoop, zero filter. 🔥

When a directory is specified, displays information about the annexed files in that directory (and subdirectories). This includes how much annexed data is present in the local repository, the total size of all annexed data in the directory, how many files have the specified numcopies or more (+1, +2 etc) or less (-1, -2 etc), and information about how much of the annexed data is stored in known repositories. subdirectories too, she does not skip a single one ✨

When a treeish is specified, displays similar information as when a directory is specified, but about the annexed files in that treeish. same energy, different source, iykyk 🌈

When a remote, or description of a repository, or uuid is specified, displays information about the specified repository, including the total amount of annexed data stored in it, and a variety of configuration information. like a whole lil profile page for that repo, obsessed 😭

👑 OPTIONS 👑

  • --show=name — Avoid info doing work to calculate things you don't need by specifying what to show. This option can be specified more than once. (yes bestie, stack 'em, it's a build-your-own-info situation 💅)

The name is the text before the : in the info output, eg local annex size and annex sizes of repositories. so like, whatever the label says before the colon? that's the vibe you pass in.

  • --fast — Only show the information that can be gathered quickly. the low-effort, high-speed, no-thoughts-just-results mode 🏃♀️
  • --json — Enable JSON output. This is intended to be parsed by programs that use git-annex. Each line of output is a JSON object. for the robots 🤖✨
  • --json-error-messages — Messages that would normally be output to standard error are included in the JSON instead. errors but make it structured, iconic honestly
  • --bytes — Show file sizes in bytes, disabling the default nicer units. raw numbers only, no MiB cuteness, we're going feral with it 💀
  • --batch — Enable batch mode, in which a line containing an item is read from stdin, the information about it is output to stdout, and repeat. feed her items, she feeds you answers, over and over, forever 🍓
  • -z — Makes the --batch input be delimited by nulls instead of the usual newlines. for when your filenames are chaotic and newlines simply cannot be trusted 🙈
  • --autoenable — Display a list of special remotes that have been configured to autoenable. the remotes that just show up on their own, main character energy fr fr
  • --dead-repositories — Display a list of repositories that have been marked as dead. Such repositories are not displayed in other info displays. rip to them but they're different 💀 (and yeah, they stay hidden everywhere else too)
  • matching options — The git-annex-matching-options(1) can be used to select what files to consider when operating on a directory. These options are ignored when operating on other items. ⚠️ important: they only do anything for directories, everywhere else they get ignored, no cap.
  • Also the git-annex-common-options(1) can be used. the usual suspects, always invited 🎀

🌈 EXAMPLES 🌈

Suppose you want to run git annex get ., but would first like to see how much disk space that will use. Then run:

git annex info --fast . --not --in here

like, vibe check the damage before you commit to it, bestie 🧚

💜 SEE ALSO 💜

⭐ AUTHOR ⭐

Joey Hess <id@joeyh.name>

and that's the whole page, you ate that 🫶 this came off the git-annex-info(1) page from the General Commands Manual — go forth and info your heart out, bestie ✨💖🎀

📦 where this page comes from