Parallel Works
View as Markdown
Share:

pw sessions connect

Connect to a running session

Synopsis

Connect to a running session by name. The session must already be running.

For desktop sessions, this creates a local TCP listener that proxies traffic to the session's WebSocket endpoint.

For tunnel sessions, this creates an SSH port forward to the session's remote host and port.

VS Code sessions are not supported by connect. Use pw session open to open in the browser or pw vscode for local VS Code.

Press Ctrl+C to disconnect. This does not stop the session.

pw sessions connect <session-name> [flags]

Examples

  pw session connect my-desktop
  
  # Connect to a tunnel session on a specific local port
  pw session connect --port 8080 my-tunnel

Options

  -h, --help       help for connect
      --port int   Local port to use (0 = auto-select)

Options inherited from parent commands

      --context string         The context to use. Overrides PW_CONTEXT environment variable and current context from config.
      --platform-host string   The Parallel Works ACTIVATE platform host to use. Will override any other platform host settings.
  -v, --verbose                Enable verbose logging

SEE ALSO