Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.murmur.dev/llms.txt

Use this file to discover all available pages before exploring further.

Opens an SSH connection to a running agent’s VM. Use it to inspect the filesystem, watch logs, or attach directly to the agent’s live coding session.

​
Synopsis

murmur ssh [flags] <slug> [-- <command...>]
Everything after -- is executed as a command on the VM instead of opening an interactive shell.

​
Arguments

NameTypeRequiredDescription
slugstringyesThe agent’s slug.
--attachboolnoAttach to the agent’s claude tmux session. Default: false.
-vboolnoShow SSH debug output. Default: false.
--workspacestringnoWorkspace name. Overrides the value from murmur.yaml.

​
Examples

​
Open an interactive shell

murmur ssh fix-auth
Opens a terminal on the agent’s VM. You land in a standard shell and can browse the cloned repo, read logs, or run commands.

​
Attach to the agent’s coding session

murmur ssh fix-auth --attach
Attaches to the claude tmux session where the agent is working. You see its live terminal output in real time. Detach with Ctrl-b d.

​
Run a single command

murmur ssh fix-auth -- git log --oneline -5

a1b2c3d Fix JWT expiry check
d4e5f6a Add token refresh test
7890abc Refactor auth middleware
bcd1234 Update go.mod
ef56789 Initial scaffold
Runs the command on the VM and exits. No interactive shell is opened.

​
Verbose output for debugging

murmur ssh fix-auth -v
Prints SSH connection diagnostics to stderr. Useful when a connection is hanging or failing.

​
Errors

CodeMeaningWhat to do
NOT_FOUNDNo agent with that slug exists.Check the slug. Use murmur ls to list running agents.
UNAUTHENTICATEDIdentity token is missing or expired.Run murmur auth or check your murmur.local.yaml configuration.
FAILED_PRECONDITIONThe agent’s VM is not running.The agent may be sleeping. Run murmur wake first.
ssh is not supported on VMsYou ran murmur ssh from inside an agent VM.Run this command from your laptop, not from a VM.
no ssh_public_keys in local configNo SSH keys are configured.Run murmur setup to register your SSH public keys.