git-annex-unannex(1)

💖 git-annex-unannex — the "undo my oops" command

okay bestie, welcome to the git-annex-unannex(1) manual page, aka the glow-up reversal spell for when your finger slipped and you ran git annex add on something you did not mean to add. no cap, we've all been there. 🙈

✨ SYNOPSIS ✨

git annex unannex [path ...]

🌸 DESCRIPTION 🌸

so here's the vibe: you accidentally ran git annex add and now you're sitting there like 😭. use this command to undo that. it puts the file back how it was before the add. literally undoes it. the way that it just fixes your whole situation? iconic. 💅

⚠️ but listen — for safety, the content of the file remains in the annex until you use git annex unused and git annex dropunused. so it's not gone-gone, it's just... chilling in there. do those two steps if you actually want it gone. 🫶

and now the part where I have to be a little bit real with you: this is not the command for you if you intentionally added a file a while ago and just don't want its contents anymore. different situation, different tool, bestie. in that case you should use git annex drop instead — and you can also git rm the file. periodt. 🔥

🎀 OPTIONS 🎀

• --fast — normally this does a slow copy of the file. in --fast mode, it instead makes a hard link from the file to the content in the annex. but use --fast mode with caution, because editing the file will change the content in the annex. yeah. that's the whole thing. do not play with it. 💀
• --json — enable JSON output. this is intended to be parsed by programs that use git-annex. each line of output is a JSON object. very much for the robots, not for the vibes. 🤖✨
• --json-error-messages — messages that would normally be output to standard error are included in the JSON instead. so all the little sad messages get tucked into the JSON. 🫶
• file matching options — the git-annex-matching-options(1) can be used to specify files to unannex. yes, you get to be picky about which files. main character energy. 👑
• Also the git-annex-common-options(1) can be used. 🌈

👀 SEE ALSO 👀

• git-annex(1) — the mothership. go read her. 💜

✍️ AUTHOR ✍️

Joey Hess <id@joeyh.name> — the legend himself. no notes. 💖

🦋 okay that's the whole page bestie!! you've officially read the git-annex-unannex(1) manual page, part of the git-annex family. now go un-add that file and live your truth. slay, stay hydrated, and always double-check before you git annex add something. iykyk. 🎀✨🌸🫶👑