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

> Rotate the credentials and secrets injected into a running agent's VM without restarting the agent — picks up new secret values immediately.

Rotates credentials on a running [agent](/concepts/agents) and its children. Use this after updating your [profile](/concepts/secrets) — for example, after rotating an API key or GitHub token — to propagate fresh credentials to agents without restarting them.

<Note>
  This command runs from your laptop only. It is not available on agent VMs.
</Note>

## Synopsis

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

## Arguments

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

## Examples

### Rekey a running agent

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

```
Rekeyed
```

### Rekey with an explicit workspace

```bash theme={null}
murmur rekey --workspace backend fix-auth
```

```
Rekeyed
```

## Errors

| Code                            | Meaning                                             | What to do                                                                      |
| ------------------------------- | --------------------------------------------------- | ------------------------------------------------------------------------------- |
| `NOT_FOUND`                     | No [agent](/concepts/agents) 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`](/cli/auth) or check your `murmur.local.yaml` configuration. |
| `rekey is not supported on VMs` | The command was run from an agent VM.               | Run [`murmur rekey`](/cli/rekey) from your laptop instead.                      |

## Related

* [Agents](/concepts/agents) — what agents are and how they work
* [Profiles and secrets](/concepts/secrets) — how credentials are managed
* [`murmur status`](/cli/status) — check agent status
* [`murmur spawn`](/cli/spawn) — start an agent
* [`murmur kill`](/cli/kill) — cancel an agent