Documentation Index
Fetch the complete documentation index at: /llms.txt
Use this file to discover all available pages before exploring further.
Tunnel one or more local ports to ports on an agent’s VM over SSH — for hitting dev servers, databases, or services running inside an agent.
Ctrl-C.
murmur port-forward [flags] <slug> <port> [port ...]
--insecure flag disables TLS on the tunnel connection. Only use it for local development when the tunnel endpoint does not have a certificate configured.murmur port-forward fix-auth 8080
Tunneling to fix-auth via port-proxy.example.com:443...
✓ localhost:54321 → remote:8080
Press Ctrl-C to close all tunnels.
http://localhost:54321 in your browser to reach the service running on port 8080 of the agent’s VM.
murmur port-forward fix-auth 3000 5432
Tunneling to fix-auth via port-proxy.example.com:443...
✓ localhost:61200 → remote:3000
✓ localhost:61201 → remote:5432
Press Ctrl-C to close all tunnels.
Ctrl-C.
murmur port-forward --workspace data-team etl-runner 5432
Tunneling to etl-runner via port-proxy.example.com:443...
✓ localhost:52100 → remote:5432
Press Ctrl-C to close all tunnels.
| 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. |
port-forward is not supported on VMs | You ran murmur port-forward from inside an agent VM. | Run this command from your laptop, not from a VM. |
invalid port | A port argument is not a number or is outside 1—65535. | Pass valid port numbers as positional arguments. |
no ports specified | No port arguments were provided. | Add at least one port number after the slug. |
murmur ssh — open a terminal on the agent’s VMmurmur status — check an agent’s phase and progressmurmur ls — list running agentsmurmur wake — restart a sleeping agent’s VM