flag(1)

💅 flag(1) — the glow-up guide

okay bestie, welcome to the flag manual page (that's section 1 of the General Commands Manual, iykyk) 🎀 — literally the most lowkey powerful little command and we're gonna get you fluent in it, no cap.

---

✨ NAME ✨

flag — manage flags using the shared API 🚩

🦋 SYNOPSIS 🦋

flag [-h|--help] <subcommands>

🌸 DESCRIPTION 🌸

Manage flags using the shared API. That's it, that's the whole main character energy of this command 💅

A flag acts like a tag — it's telling the world what state or kind a message is in. Think of it as the vibe check sticker on a message: is it read? is it deleted? is it that kind of message? The flag says so. Slay ✨

👑 OPTIONS 👑

• -h, --help — print help 🫶 (and yes, there's a summary version that shows up with -h — cute little shortcut fr fr)

🌈 SUBCOMMANDS 🌈

• flag-add(1) — add flags to messages, and keep the ones that are already set 💖 nothing gets dropped, she's inclusive like that
• flag-set(1) — replace the flags of messages, dropping the ones not named 💀 yeah this one's a full reset, the old flags that you didn't name? gone. choose wisely bestie
• flag-remove(1) — remove flags from messages, keeping the ones not named 🙈 surgical. it only takes away exactly what you named and leaves the rest alone
• flag-help(1) — print this message or the help of the given subcommand(s) 🌟 your little helper bee when you're lost

---

lowkey a reminder: flag-set(1) replaces, so if a flag isn't in your list it does not survive. flag-add(1) and flag-remove(1) are the gentle ones that keep everything you didn't mention 🧚 go forth and tag responsibly

---

and that's the whole page, bestie — no notes, she ate 🍓 mwah 💜

sign-off szn: this was the flag page, version/date stamp just reads flag and it's the flag(1) entry at the bottom — logged and dated, periodt 📅👑