Skip to main content
Downloads an agent’s persisted Claude Code session file so you can resume the conversation locally with claude --resume. By default this downloads the session as last persisted — written when the agent’s VM went to sleep, or on the periodic keep-alive backup. Pass --fresh to ask the running agent to upload a snapshot of its current session first, so the download is up to date even mid-run.

​
Synopsis

murmur session download [flags] [slug]
On a VM, the slug is optional — omitting it downloads the current agent’s own session.

​
Arguments

NameTypeRequiredDescription
slugstringon laptopThe agent’s slug. Optional on VMs (defaults to self).
--freshboolnoAsk the live agent to upload its current session before downloading. Requires agent.edit permission and a running workflow. When no run has happened since the last upload, the upload is skipped — repeated fresh downloads are cheap. Default: false.
--outputstringnoOutput file path. Default: ./<slug>.session.jsonl.
--workspacestringnoWorkspace name. Overrides the value from murmur.yaml.

​
Examples

​
Download the last-persisted session

murmur session download fix-auth

Downloading session for fix-auth...
Session saved to fix-auth.session.jsonl

To resume locally:
  claude --resume fix-auth.session.jsonl

​
Download a fresh snapshot from a running agent

murmur session download --fresh fix-auth

Requesting fresh session upload from fix-auth...
Fresh session uploaded.
Downloading session for fix-auth...
Session saved to fix-auth.session.jsonl

​
Errors

CodeMeaningWhat to do
NOT_FOUNDNo agent with that slug exists, or it has no persisted session.Check the slug. Use murmur ls to list agents.
NOT_FOUND (with --fresh)The agent’s workflow is not running.Drop --fresh to download the last persisted session of a terminated agent.
FAILED_PRECONDITION (with --fresh)The agent is sleeping and its sleep-time session persist failed.Wake the agent (e.g. murmur queue-add) and retry.
UNAUTHENTICATEDIdentity token is missing or expired.Run murmur auth or check your murmur.local.yaml configuration.