Skip to main content
  1. Posts/

uvx ptn, Scan a QR, Get a Terminal in Your Phone

··293 words·2 mins·

📱 Want to code from bed? Here’s the simplest solution.

With uvx ptn, just three steps:

  1. Run uvx ptn
  2. Scan the QR with your phone
  3. You have a terminal on your phone!

No SSH, no port forwarding, no complex configuration. It uses a Cloudflare tunnel to securely and temporarily expose your terminal.


🔑 What makes it different?
#

The author tried alternatives before building this:

  • ngrok → requires registration and the free tier is limited
  • Cloudflare Quick Tunnel → works well but hard to use from mobile
  • Termius → complicated setup: port forwarding, firewall, SSH key management…
  • Claude Code web → can’t access local hardware
  • Happy → too bulky and slow updates

So he built something simpler: one command, one QR, start typing.


🛠️ Key features
#

  • 📲 One command, instant access — No prior setup needed
  • 📑 Multi-tab shared sessions — Run builds in one tab, tail logs in another
  • 🌐 Cross-platform — Windows (PowerShell, CMD, WSL), Linux/macOS (Bash, Zsh, Fish)
  • 🔧 Custom buttons — Configure shortcuts like claude, tmux, etc.

💡 In a nutshell
#

Porterminal is a Python tool that with a single command creates a secure tunnel between your computer and any device with a browser. It automatically generates a QR code with the tunnel URL. Scanning it from your phone opens a fully functional web terminal in your browser. Perfect for checking logs, making small changes, or “vibecoding” from wherever you are.

⚠️ Security: The URL is the only authentication. Don’t share it and stop the server when not in use.

More information at the link 👇

Also published on LinkedIn.
Juan Pedro Bretti Mandarano
Author
Juan Pedro Bretti Mandarano