murmur ssh

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.

Name	Type	Required	Description
`slug`	string	yes	The agent’s slug.
`--attach`	bool	no	Attach to the agent’s `claude` tmux session. Default: `false`.
`-v`	bool	no	Show SSH debug output. Default: `false`.
`--workspace`	string	no	Workspace name. Overrides the value from `murmur.yaml`.

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.

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.

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.

murmur ssh fix-auth -v

Prints SSH connection diagnostics to stderr. Useful when a connection is hanging or failing.

Code	Meaning	What to do
`NOT_FOUND`	No agent with that slug exists.	Check the slug. Use `murmur ls` to list running agents.
`UNAUTHENTICATED`	Identity token is missing or expired.	Run `murmur auth` or check your `murmur.local.yaml` configuration.
`FAILED_PRECONDITION`	The agent’s VM is not running.	The agent may be sleeping. Run `murmur wake` first.
`ssh is not supported on VMs`	You ran `murmur ssh` from inside an agent VM.	Run this command from your laptop, not from a VM.
`no ssh_public_keys in local config`	No SSH keys are configured.	Run `murmur setup` to register your SSH public keys.