murmur session download

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

Name	Type	Required	Description
`slug`	string	on laptop	The agent’s slug. Optional on VMs (defaults to self).
`--fresh`	bool	no	Ask 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`.
`--output`	string	no	Output file path. Default: `./<slug>.session.jsonl`.
`--workspace`	string	no	Workspace 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

Code	Meaning	What to do
`NOT_FOUND`	No 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.
`UNAUTHENTICATED`	Identity token is missing or expired.	Run `murmur auth` or check your `murmur.local.yaml` configuration.

Agents — concept overview
murmur session watch — stream live session events
murmur session send — send a follow-up message to the agent
murmur spawn --resurrect — resume a dead agent in the cloud with its session

Getting Started

Core Concepts

Guides

murmur session download

Synopsis

Arguments

Examples

Download the last-persisted session

Download a fresh snapshot from a running agent

Errors

​Synopsis

​Arguments

​Examples

​Download the last-persisted session

​Download a fresh snapshot from a running agent

​Errors

​Related

Synopsis

Arguments

Examples

Download the last-persisted session

Download a fresh snapshot from a running agent

Errors

Related