murmur sleep

Stops an agent’s 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. Use murmur sleep to save compute costs on agents you want to keep alive but don’t need running right now.

Synopsis

murmur sleep [flags] [path]

On a VM, the path is optional. If you omit it, the command puts the current agent to sleep.

Arguments

Name	Type	Required	Description
`path`	string	on laptop	The agent’s slug, or a slash-separated path to a descendant (e.g. `director/fix-auth`). Use an absolute path like `/w/{workspace}/{owner_provider}/{account}/{slug}` for an agent outside your own path. On a VM, a relative path names a child of the calling agent, and omitting it targets the calling agent itself.
`--json`	bool	no	Print the `SleepResponse` as JSON instead of the confirmation line. Default: `false`.
`--workspace`	string	no	Workspace name. Overrides the value from `murmur.yaml`.

Output

VM stopped

Examples

Put an idle agent to sleep

murmur sleep fix-auth

VM stopped

Confirm the agent is sleeping

murmur status fix-auth

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

Wake it back up later

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` to see running agents.
`UNAUTHENTICATED`	Identity token is missing or expired.	Run `murmur login` or check your `murmur.local.yaml` configuration.

Agents: concept overview
murmur wake: restart a sleeping agent’s VM
murmur wait: block until an agent reaches a target phase
murmur status: check an agent’s current status
murmur kill: cancel an agent permanently

Getting Started

Core Concepts

Guides

Synopsis

Arguments

Output

Examples

Put an idle agent to sleep

Confirm the agent is sleeping

Wake it back up later

Errors

​Synopsis

​Arguments

​Output

​Examples

​Put an idle agent to sleep

​Confirm the agent is sleeping

​Wake it back up later

​Errors

​Related

Synopsis

Arguments

Output

Examples

Put an idle agent to sleep

Confirm the agent is sleeping

Wake it back up later

Errors

Related