Show HN: Uvx Ptn, Scan a QR, Get a Terminal in Your Phone

Why It Matters

By turning any machine into an instant, mobile‑accessible shell, Porterminal speeds up remote development and reduces configuration overhead, a competitive edge for distributed teams and on‑the‑go engineers.

Key Takeaways

• One command launches tunnel, QR grants instant mobile terminal.
• Supports Windows, macOS, Linux, multiple shells, multi-tab sessions.
• No SSH keys; URL is sole authentication, security caution.
• Installable via uvx, pipx, uv, or pip with single line.
• Open-source AGPL-3.0, customizable toolbar via YAML config.

Pulse Analysis

Remote development has long relied on heavyweight solutions like ngrok or manual SSH tunnels, which demand registration, key management, and often a desktop client. Porterminal flips this model by leveraging Cloudflare’s edge network to create a secure tunnel that can be accessed through a QR code, turning a smartphone into a fully functional terminal without any additional software. This approach reduces friction for developers who need quick, on‑the‑move access to local environments, especially in constrained or BYOD settings.

Technically, Porterminal bundles a Python‑based CLI that auto‑installs the cloudflared binary if missing, then spins up a tunnel and serves a minimal web UI. The QR code encodes the public URL, which is the sole authentication token—anyone with the link gains full shell access, so users must treat it like a password. The tool supports Windows PowerShell, CMD, WSL, as well as Bash, Zsh, and Fish on macOS/Linux, and it preserves multi‑tab sessions across reconnects. Installation is intentionally frictionless: a single `uvx ptn` or `pipx install ptn` command sets up the environment, and updates are handled with the same package manager.

For enterprises and open‑source contributors, Porterminal’s AGPL‑3.0 license encourages community‑driven enhancements while ensuring that any modifications remain open. Its YAML‑driven toolbar lets teams embed custom shortcuts—such as launching a build script or attaching to tmux—directly into the mobile UI. As remote work solidifies as the norm, tools that democratize access to local development resources without compromising security are poised to become essential components of the modern DevOps toolkit.