LOCALSEARCH-TAG(1)

💅 NAME 💅

localsearch-tag — literally the tag manager: add tags, remove tags, and list tags. That's the whole gig ✨

(also hi, this is the LocalSearch manual page for localsearch-tag(1), welcome to the group chat 🫶)

---

✨ SYNOPSIS ✨

localsearch tag FILE [-l <limit>] [-o <offset>] [-r]
localsearch tag -t [-s] [-r] FILE
localsearch tag -a <TAG> [-e <description>]
localsearch tag -d <TAG>

---

🦋 DESCRIPTION 🦋

So you can list tags for your local files — or, if you pass -t, you can list by the tag labels themselves instead. Iconic behavior, no cap 👑

You can also manage tags with the -a option and the -d option. Yes bestie, you get to actually create and delete them, not just look at them 💅

The FILE argument can be either a local path or a URI. It also doesn't have to be an absolute path — lowkey flexible like that 🌸

---

🎀 OPTIONS 🎀

• -t, --list — Lists all the tags. Each result comes with the number of files associated with that tag plus the tag's unique identifier. Obsessed? Same. And if you want to see the actual files hanging out with each tag, use --show-files 💖
• -s, --show-files — Shows the files associated with each tag. Heads up though: this one is ONLY available WITH the --list option. It doesn't do the solo thing 🙈
• -a, --add=TAG — Adds a tag named TAG. If you don't give a FILE argument, the tag is just created on its own (if it didn't already exist) with no files associated with it. A little tag with no friends yet, we love a blank slate 🧚
• -d, --delete=TAG — Deletes the tag named TAG. And if there's no FILE argument specified, the tag gets deleted for ALL files. Yep, all of them. Big delete energy 💀
• -e, --description=STRING — This option ONLY applies when you're using --add, and it gives your tag label a description matching STRING. Give your tags lore, they deserve it 📝
• -l, --limit=N — Caps the search at N results. The default is 512. Yes, a real number, we're not making it up ⭐
• -o, --offset=N — Offsets the search results by N. For example, start right at item number 10 in the results. The default is 0. Sliding into the results like:

$ localsearch tag -s -t banana

That should show the files in the database that have both the banana tag 🍌 (yes, that's the example straight from the page, and yes, we're keeping the wording exactly like that 😭)

---

🌈 SEE ALSO 🌈

• localsearch search(1)
• localsearch info(1)

They're the sibling pages, go say hi 🫶

---

okay that's the whole thing, you're a localsearch-tag expert now, literally so proud of you 💜 this page was brought to you by the LocalSearch manual, version 3.12.0, dated 09/15/2026 — mwah, go tag something cute 🎀✨💅