> ## Documentation Index
> Fetch the complete documentation index at: https://docs.murmur.dev/llms.txt
> Use this file to discover all available pages before exploring further.

# murmur notify

> Send a free-text out-of-band message to a running agent — appears in the session as a system note without interrupting the current turn.

Publishes a `notify` [event](/concepts/events) to a running [agent](/concepts/agents). The [agent](/concepts/agents) receives the message in its [event](/concepts/events) stream and acts on it. Use this to give instructions, provide context, or nudge an [agent](/concepts/agents) without queuing a formal follow-up.

## Synopsis

```bash theme={null}
murmur notify [flags] <slug> <message>
```

The message is everything after the slug. Multiple words are joined with spaces — no quoting required.

## Arguments

| Name          | Type   | Required | Description                                                                           |
| ------------- | ------ | -------- | ------------------------------------------------------------------------------------- |
| `slug`        | string | yes      | The [agent's](/concepts/agents) slug.                                                 |
| `message`     | string | yes      | The message text. All remaining arguments after the slug are joined into the message. |
| `--workspace` | string | no       | [Workspace](/concepts/workspaces) name. Overrides the value from `murmur.yaml`.       |

## Examples

### Send a message to an agent

```bash theme={null}
murmur notify fix-auth Check the error handling in middleware.go too
```

```
notified fix-auth
```

The [agent](/concepts/agents) receives the message as a `notify` [event](/concepts/events):

```
[2026-05-14T18:45:00Z] Check the error handling in middleware.go too
```

### Nudge a stuck agent

```bash theme={null}
murmur notify fix-auth The CI failure is a flaky test — rerun it
```

```
notified fix-auth
```

## Errors

| Code              | Meaning                                             | What to do                                                                             |
| ----------------- | --------------------------------------------------- | -------------------------------------------------------------------------------------- |
| `NOT_FOUND`       | No [agent](/concepts/agents) with that slug exists. | Check the slug. Use [`murmur ls`](/cli/ls) to list running [agents](/concepts/agents). |
| `UNAUTHENTICATED` | Identity token is missing or expired.               | Run `murmur auth` or check your `murmur.local.yaml` configuration.                     |

## Related

* [Events](/concepts/events) — concept overview of event types and delivery
* [`murmur watch`](/cli/watch) — stream events for an agent in real time
* [`murmur queue add`](/cli/queue-add) — send a follow-up task to an agent
* [`murmur status`](/cli/status) — check an agent's phase and progress