Flush destroys warm VMs immediately. With --nuke, it also terminates every running agent workflow and deletes every VM in the tenant. The --nuke flag is irreversible — all in-progress work that has not been pushed or opened as a pull request is lost.
Destroys idle (warm) VMs in the pool. The pool workflow then replenishes with fresh VMs built from the current base image. Running agents are not affected — only warm VMs waiting for assignment are deleted.
Use this after changing an environment configuration or baking a new image, so that newly spawned agents pick up the changes.
Synopsis
murmur pool flush [flags]
Pool commands run from your laptop only. They are not available on agent VMs.
Arguments
| Name | Type | Required | Description |
|---|
--nuke | bool | no | Terminate all agent workflows and delete all VMs, not just warm ones. Default: false. |
--workspace | string | no | Workspace name. Overrides the value from murmur.yaml. |
Output
Without --nuke, prints the number of warm VMs flushed:
Flushing warm VMs...
Flushed 3 warm VMs — pool will replenish with fresh ones
If no warm VMs exist:
Flushing warm VMs...
No warm VMs to flush
With --nuke, prints the total number of workflows terminated and VMs deleted:
Nuking all workflows and VMs...
Nuke complete (12 terminated/deleted)
Examples
Flush warm VMs after a new image bake
Flushing warm VMs...
Flushed 2 warm VMs — pool will replenish with fresh ones
The pool begins provisioning replacement VMs from the latest base image.
Nuclear reset
This terminates every running agent and deletes every VM in the tenant. Use only when you need to start completely fresh.
Nuking all workflows and VMs...
Nuke complete (8 terminated/deleted)
Errors
| Code | Meaning | What to do |
|---|
UNAUTHENTICATED | Identity token is missing or expired. | Run murmur auth or check your murmur.local.yaml configuration. |
PERMISSION_DENIED | Your role does not have pool-config.delete permission. | Ask a tenant admin to grant you the required permission. |
| (exit error) | pool commands are not supported on VMs | Run this command from your laptop, not from an agent VM. |