> ## 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 session send

> Send a follow-up message to a running agent's session — bypasses the queue and is delivered as soon as the current turn completes.

Sends a follow-up message to a running [agent's](/concepts/agents) session. The message is delivered to the [agent](/concepts/agents) as a new user prompt. If the [agent](/concepts/agents) is idle or has finished its current task, the message wakes it to start a new turn.

## Synopsis

```bash theme={null}
murmur session send [flags] [slug] <message...>
```

On a VM, the slug is optional — omitting it sends the message to the current [agent's](/concepts/agents) own session. The message is everything after the slug (or everything after the flags, on a VM).

## Arguments

| Name          | Type   | Required  | Description                                                                     |
| ------------- | ------ | --------- | ------------------------------------------------------------------------------- |
| `slug`        | string | on laptop | The [agent's](/concepts/agents) slug. Optional on VMs (defaults to self).       |
| `message`     | string | yes       | The message text. All remaining arguments are joined with spaces.               |
| `--workspace` | string | no        | [Workspace](/concepts/workspaces) name. Overrides the value from `murmur.yaml`. |

## Examples

### Send a follow-up message

```bash theme={null}
murmur session send fix-auth "Also add a test for the token refresh case"
```

```
sent
```

### Multi-word message without quotes

All arguments after the slug are joined into a single message:

```bash theme={null}
murmur session send fix-auth Also add a test for the token refresh case
```

```
sent
```

### Send from a VM (self)

When running on an [agent](/concepts/agents) VM, omit the slug:

```bash theme={null}
murmur session send "Please also check the error handling path"
```

```
sent
```

## 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

* [Agents](/concepts/agents) — concept overview
* [`murmur session watch`](/cli/session-watch) — stream live session events
* [`murmur session interrupt`](/cli/session-interrupt) — interrupt the agent's current turn
* [`murmur session stop`](/cli/session-stop) — request graceful session shutdown
* [`murmur status`](/cli/status) — check an agent's phase and progress