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

> Request graceful shutdown of a running agent's session — the agent finishes its current turn, reports artifacts, and then terminates.

Requests graceful shutdown of a running [agent's](/concepts/agents) session. The [agent](/concepts/agents) finishes any in-progress operation and then ends the session. Use this when you want the [agent](/concepts/agents) to wind down cleanly — to cancel an [agent](/concepts/agents) immediately, use [`murmur kill`](/cli/kill) instead.

## Synopsis

```bash theme={null}
murmur session stop [flags] [slug]
```

On a VM, the slug is optional — omitting it stops the current [agent's](/concepts/agents) own session.

## Arguments

| Name          | Type   | Required  | Description                                                                     |
| ------------- | ------ | --------- | ------------------------------------------------------------------------------- |
| `slug`        | string | on laptop | The [agent's](/concepts/agents) slug. Optional on VMs (defaults to self).       |
| `--workspace` | string | no        | [Workspace](/concepts/workspaces) name. Overrides the value from `murmur.yaml`. |

## Examples

### Stop an agent's session

```bash theme={null}
murmur session stop fix-auth
```

```
sent
```

### Stop from a VM (self)

```bash theme={null}
murmur session stop
```

```
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 send`](/cli/session-send) — send a follow-up message to the agent
* [`murmur session interrupt`](/cli/session-interrupt) — interrupt the agent's current turn
* [`murmur kill`](/cli/kill) — cancel an agent immediately
* [`murmur status`](/cli/status) — check an agent's phase and progress