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

> Restart a sleeping agent's VM and resume its coding session from where it left off, without losing any session state or workspace files.

Restarts a sleeping [agent's](/concepts/agents) VM. The agent transitions from `PHASE_SLEEPING` back to its previous active phase and resumes work. Use [`murmur wake`](/cli/wake) to bring an agent back after putting it to [sleep](/cli/sleep).

Agents also wake automatically when they receive a follow-up message — [`murmur wake`](/cli/wake) is for when you want to restart the VM without sending new work.

## Synopsis

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

On a VM, the slug is optional — omitting it wakes the current agent.

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

## Examples

### Wake a sleeping agent

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

```
VM started
```

### Confirm the agent is running

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

```
workflow: github_oauth/alice/w/backend/fix-auth
phase:    PHASE_RUNNING
vm:       murmur-a1b2c3d4 (acme-agents/us-central1-a) [running]
version:  0.4+a1b2c3d4
```

### Sleep and wake cycle

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

```
VM stopped
```

```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 sleep`](/cli/sleep) — stop an agent's VM while preserving state
* [`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