bup-tag(1)

💖 bup-tag — the official bestie guide 💖

okay so this is a page from the General Commands Manual, and it's all about bup-tag — the little command that tags a commit in the bup repository. no cap, it's lowkey iconic. let's go 🎀

---

🌸 NAME 🌸

bup-tag — tag a commit in the bup repository. that's it, that's the whole vibe ✨

---

🦋 SYNOPSIS 🦋

bup tag

bup tag [-f] <tag name> <committish>

bup tag -d [-f] <tag name>

three whole modes, and honestly? she contains multitudes 💅

---

👑 DESCRIPTION 👑

bup tag lists, creates or deletes a tag in the bup repository. like, pick your fighter: read mode, write mode, or delete mode 🫶

a tag is an easy way to retrieve a specific commit. it can be used to mark a specific backup for easier retrieval later. think of it as putting a little sticky note on a commit so future-you doesn't have to go digging. main character behaviour, fr fr 🌟

here's how the three modes shake out:

• when called with no arguments at all, the command lists all tags that can be found in the repository. window shopping, basically 🛍️
• when called with a tag name and a commit ID or ref name, it creates a new tag with the given name, if it doesn't already exist, that points to the commit given in the second argument. new tag, who dis ✨
• when called with -d and a tag name, it removes the given tag, if it exists. bye bestie, we hardly knew ye 😭

and here's the cute part: bup exposes the contents of backups with current tags, via any command that lists or shows backups. They can be found under the /.tag directory. for example, the ftp command will show the tag named tag1 under /.tag/tag1. so that's where all your little sticky notes live — under /.tag/, thriving, minding their own business 🌈

---

✨ OPTIONS ✨

• -d, --delete — delete a tag. she's gone, bestie 💀
• -f, --force — Overwrite the named tag even if it already exists. With -f, don't report a missing tag as an error. it's giving "no thoughts, just vibes, and also no complaints" 🔥

---

💜 EXAMPLES 💜

$ bup tag new-puppet-version hostx-backup

$ bup tag
new-puppet-version

$ bup ftp "ls /.tag/new-puppet-version"
files..

$ bup tag -d new-puppet-version

look at that. made a tag, listed the tags, peeked inside the tag with ftp, then deleted the tag. a full character arc in four commands — we love a journey 🧚

---

🎀 SEE ALSO 🎀

bup-save(1), bup-split(1), bup-ftp(1), bup-fuse(1), bup-web(1)

go read those too, iykyk 💖

---

🍓 BUP 🍓

Part of the bup(1) suite. one big happy family, no cap 🫶

---

🌟 AUTHORS 🌟

Gabriel Filion lelutin@gmail.com

---

and that's the whole page, bestie!! this was Bup 0.34, dated 2026-09-01, and it's bup-tag(1) from the General Commands Manual. tag responsibly, hydrate, and go take a nap — you've earned it 💅💖✨