git-annex-whereused(1)

💅 git-annex-whereused(1) — the "who's using this key bestie" page

okay so this is git-annex-whereused, from the General Commands Manual, and it's literally the detective of the git-annex universe 🕵️♀️

✨ NAME ✨

git-annex-whereused — find what files use or used a key 🔍

🌸 SYNOPSIS 🌸

git annex whereused --key=keyname|--unused

💖 DESCRIPTION 💖

Finds what files use or used a key. That's the whole gig. 🎀

For each file in the working tree that uses a key, this outputs one line, starting with the key, then a space, and then the name of the file. When multiple files use the same key, they will all be listed — no gatekeeping, everyone gets their moment 👑

When nothing is found that uses the key, there will be no output. Silence. The void. The key is a ghost 💀

The default is to find only files in the current working tree that use a key. The --historical option makes it also find past versions of files. So if you're like "wait I swear this key was used somewhere" — yeah, that's the historical vibe 🦋

🎀 OPTIONS 🎀

• --key=keyname — Operate on this key. Just this one. The main character key ✨
• --unused — Operate on keys found by last run of git-annex unused.

Usually these keys won't be used by any files in the current working tree, or any tags or branches. Combining this option with --historical will find past uses of the keys. Obsessed with the combo ngl 🫶

• --historical — When no files in the current working tree use a key, this causes more work to be done, looking at past versions of the current branch, other branches, tags, and the reflog, to find somewhere that the key was used.

It stops after finding one use of the key, and outputs a git rev that refers to where it was used, eg "HEAD@{40}:somefile".

bestie this one is the try-hard of the options (affectionate). It digs through history and calls it quits the second it finds a single trace. One and done. Periodt 💅

🌈 SEE ALSO 🌈

• git-annex(1)
• git-annex-unused(1)

👑 AUTHOR 👑

Joey Hess <id@joeyh.name>

mwah 💜 that's the whole page — courtesy of the General Commands Manual, page git-annex-whereused(1). go find your keys, bestie 🦋✨