murmur session download

Downloads an agent’s persisted session file so you can resume the conversation locally with the agent’s backend CLI: claude --resume for Claude Code agents, codex resume (or murmur resume) for codex agents. By default, this downloads the last persisted session, written when the agent’s VM went to sleep or during 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. If you omit it, the command 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`, with `/` in a child slug replaced by `-`.
`--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

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

When no run has happened since the last upload, the second line reads Persisted session is already current. instead.

Download a codex agent’s session

A codex session resumes by thread ID, not file path, so the instructions differ:

murmur session download review-bot

Downloading session for review-bot...
Session saved to review-bot.session.jsonl (codex thread 019a3f2e-7c41-7d20-9b8e-2f6a1c0d4e55)

To resume locally:
  murmur resume /w/acme/github_oauth/alice/review-bot
or manually: install the file under ~/.codex/sessions/ (dated dir + rollout-<ts>-<id>.jsonl name) and run
  codex resume 019a3f2e-7c41-7d20-9b8e-2f6a1c0d4e55

All progress and resume lines are written to stderr.

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 login` 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

Download a codex agent’s session

Errors

​Synopsis

​Arguments

​Examples

​Download the last-persisted session

​Download a fresh snapshot from a running agent

​Download a codex agent’s session

​Errors

​Related

Synopsis

Arguments

Examples

Download the last-persisted session

Download a fresh snapshot from a running agent

Download a codex agent’s session

Errors

Related