reminal
Zero-config remote terminal sharing over HTTPS
TLDR
SYNOPSIS
reminal [command] [options]
DESCRIPTION
reminal is a Go CLI that shares a persistent PTY on your machine through an encrypted WebSocket relay, so you can reconnect from a browser, phone, or another reminal client without opening inbound ports or managing SSH keys.Running reminal generates an ephemeral session ID and PIN, displays a QR code, and keeps the shell alive while viewers connect. The relay sees only ciphertext; session credentials die when the agent exits. Viewers can use the built-in web terminal at the relay URL or connect with reminal connect.The host only makes outbound HTTPS/WSS connections, which works on NAT, hotel Wi-Fi, and other networks that block inbound SSH. Auto-reconnect and scrollback replay help survive brief network drops.
PARAMETERS
connect id-or-url [pin]
Attach to a remote session; prompts for PIN if omitted.info [--json]
Reprint session ID, PIN, URL, and QR for the local agent.qr
Print only the join QR code for the running agent.doctor
Check version, relay connectivity, terminal, and shell.upgrade
Download and install the latest release.relay [port]
Start a local development relay (default port 8080).completion bash|zsh|fish
Print shell completion script to stdout.version
Print version string.--connect id --pin pin
Alternative connect syntax shown in session banners.
CAVEATS
reminal depends on a relay service (Cloudflare Workers by default or a self-hosted relay). It is not a drop-in SSH replacement for arbitrary remote administration — it shares an interactive shell you already started locally. Commercial use may require a separate license under the project's dual-licensing terms.
HISTORY
reminal was created by Harshal Gajjar and released in 2026 as a zero-setup alternative to SSH for reaching your own machine from mobile devices and browsers.
SEE ALSO
ssh(1), tmux(1), caffeinate(1)
