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

> Stop a running agent's VM while preserving its session state and disk so it can be resumed later with murmur wake at the same point.

Stops an [agent's](/concepts/agents) VM. The agent's workflow and state are preserved — the VM is deallocated but the agent remains in `PHASE_SLEEPING`. A sleeping agent wakes automatically when it receives a follow-up, or manually with [`murmur wake`](/cli/wake).

Use [`murmur sleep`](/cli/sleep) to save compute costs on agents you want to keep alive but don't need running right now.

## Synopsis

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

On a VM, the slug is optional — omitting it puts the current agent to sleep.

## Arguments

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

## Output

```
VM stopped
```

## Examples

### Put an idle agent to sleep

```bash theme={null}
murmur sleep fix-auth
```

```
VM stopped
```

### Confirm the agent is sleeping

```bash theme={null}
murmur status fix-auth
```

```
workflow: github_oauth/alice/w/backend/fix-auth
phase:    PHASE_SLEEPING
vm:       murmur-a1b2c3d4 (acme-agents/us-central1-a) [stopped]
```

### Wake it back up later

```bash theme={null}
murmur wake fix-auth
```

```
VM started
```

## Errors

| Code              | Meaning                               | What to do                                                                 |
| ----------------- | ------------------------------------- | -------------------------------------------------------------------------- |
| `NOT_FOUND`       | No agent with that slug exists.       | Check the slug spelling. Use [`murmur ls`](/cli/ls) to see running 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 wake`](/cli/wake) — restart a sleeping agent's VM
* [`murmur wait`](/cli/wait) — block until an agent reaches a target phase
* [`murmur status`](/cli/status) — check an agent's current status
* [`murmur kill`](/cli/kill) — cancel an agent permanently