EMIT(1)

👑 EMIT(1) — the fish-shell girlies' guide to firing events 💅

okay so real talk, this is emit from fish-shell, and it's genuinely one of the most underrated little commands ever. let's get into it 🫶

---

✨ NAME ✨

emit — emits a generic event. that's it. that's the whole job. and she does it flawlessly 💖

---

🌸 SYNOPSIS 🌸

emit EVENT_NAME [ARGUMENTS ...]

---

🦋 DESCRIPTION 🦋

okay so emit emits, aka fires, an event. think of it like tossing a vibe into the group chat 💌

events get delivered to — or "caught by" — special functions called event handlers (fish has a whole thing about events, iykyk). and the arguments you pass along? they get handed straight to those event handlers as function arguments. no cap, that's literally it. it's giving perfect messenger energy ✨

also bestie, the --help or -h option displays help about using this command. iconic of her, honestly 🎀

---

🔥 EXAMPLE 🔥

the following code first defines an event handler for the generic event named 'test_event', and then emits an event of that type. watch and learn 👑

function event_test --on-event test_event
    echo event test: $argv
end

emit test_event something

like— the way that --on-event test_event just snaps that function into place as a handler? obsessed. then emit test_event something fires it and something rides along as $argv. main character behavior fr fr 💀💖

---

💜 NOTES 💜

heads up bestie: events are only sent to the current fish process, because there is no way to send events from one fish process to another. so no cross-process telepathy, sadly 😭 she's loyal to her own process only.

---

⭐ Copyright ⭐

fish-shell developers 💖

---

and that's the whole page, babes 🌈 — brought to you by fish-shell 4.9, dated Sep 08, 2026, lovingly copyrighted by the fish-shell developers. go forth and emit responsibly 🧚‍♀️✨🎀