EMIT(1) fish-shell EMIT(1)

# [NAME](#NAME)

emit - emit a generic event

# [SYNOPSIS](#SYNOPSIS)

```
emit EVENT_NAME [ARGUMENTS ...]
```

# [DESCRIPTION](#DESCRIPTION)

**emit** emits, or fires, an event. Events are delivered to, or caught by, special functions called event handlers <#event>. The arguments are passed to the event handlers as function arguments.

The **--help** or **-h** option displays help about using this command.

# [EXAMPLE](#EXAMPLE)

The following code first defines an event handler for the generic event named 'test\_event', and then emits an event of that type.

```
function event_test --on-event test_event


    echo event test: $argv
end
emit test_event something
```

# [NOTES](#NOTES)

Note that events are only sent to the current fish process as there is no way to send events from one fish process to another.

# [Copyright](#Copyright)

fish-shell developers

October 10, 2026 4.9

---

Document: emit(1) from fish 4.9.3-r1 (Chainguard OS)
Source: https://github.com/fish-shell/fish-shell