mo tunnel

Mo runs on its own machine, so it cannot see localhost:3000 or an internal staging host. A tunnel exposes one or more hostname:port addresses from your machine to a single Mo session through a Momentic Connector. Start the tunnel, pass its ID to mo start --tunnel, and stop it when the session is done.

mo tunnel start <address...> [--foreground]
mo tunnel stop <tunnel-id>
mo tunnel list

tunnel start

Start a tunnel to one or more addresses.

mo tunnel start localhost:3000
mo tunnel start localhost:3000 api.internal:8080

string

required

One or more hostname:port addresses reachable from this machine.

flag

Keep the tunnel attached to the terminal and run until you press Ctrl+C. By default the tunnel detaches and keeps running in the background.

When the tunnel is ready, the command prints its ID as JSON:

{ "tunnelId": "tunnel-6f1c2a4e-..." }

In background mode the command returns immediately after printing. In foreground mode it prints the ID and then blocks; stopping the process also revokes the tunnel.

tunnel stop

Stop a tunnel and revoke Mo’s access to it.

mo tunnel stop tunnel-6f1c2a4e-...

The command asks the local tunnel process to shut down, then revokes the Connector tunnel on the server. If the local process is already gone, the command still revokes the tunnel and prints a warning. On success it prints { "tunnelId": "..." }.

tunnel list

List tunnels started from this machine.

mo tunnel list

{
  "tunnels": [
    {
      "tunnelId": "tunnel-6f1c2a4e-...",
      "addresses": ["localhost:3000"],
      "mode": "detached",
      "pid": 48213,
      "startedAt": "2026-09-02T04:01:12.000Z",
      "status": "running"
    }
  ]
}

status is starting, running, unreachable (the state file exists but the process does not respond), or cleanup_failed (the process exited without revoking the tunnel; run mo tunnel stop to finish cleanup).

Example: test a local dev server

tunnel_id=$(mo tunnel start localhost:3000 | jq -r .tunnelId)
session=$(mo start "Test the signup flow on http://localhost:3000" --tunnel "$tunnel_id")
mo read "$(jq -r .sessionId <<<"$session")" --timeout 290s
mo tunnel stop "$tunnel_id"

Notes

Tunnel state lives in ~/.momentic/mo-tunnels. mo tunnel list only shows tunnels started from this machine.
One tunnel can serve several addresses; start it with every host Mo needs before you create the session.
A background tunnel outlives your shell. Stop it explicitly, or it stays open until you do.

Overview

momentic CLI

momentic-mobile CLI

mo CLI

tunnel start

tunnel stop

tunnel list

Example: test a local dev server

Notes

​tunnel start

​tunnel stop

​tunnel list

​Example: test a local dev server

​Notes

tunnel start

tunnel stop

tunnel list

Example: test a local dev server

Notes