ptn 0.1.0

Web-based terminal accessible from phone via Cloudflare Tunnel

Web terminal accessible from your phone via Cloudflare Quick Tunnel. Touch-friendly interface with virtual keys, multi-tab sessions, etc.

Features

• Touch-optimized - Virtual keyboard, touch gestures
• Multi-tab sessions - Run multiple terminals simultaneously with persistent sessions
• Instant access - Cloudflare Quick Tunnel with QR code, no port forwarding needed
• Cross-platform - Windows (PowerShell, CMD, WSL), Linux/macOS (Bash, Zsh, Fish)

Quick Start

# Install
uv tool install ptn

# Run
ptn

Scan the QR code with your phone to connect.

Alternative methods:

# Run without installing
uvx ptn

# Or with pip
pip install ptn

Usage

ptn [path] [options]

Options:
  --no-tunnel       Local network only (no Cloudflare tunnel)
  -v, --verbose     Show detailed logs
  -U, --update      Update to latest version
  -V, --version     Show version

Configuration

Create config.yaml to customize:

server:
  host: "127.0.0.1"
  port: 8000

terminal:
  cols: 120
  rows: 30
  default_shell: powershell  # cmd, wsl, bash, zsh

buttons:
  - label: "git"
    send: "git status\r"

Security

Warning: The URL is the only authentication. Anyone with the link can access your terminal.

• Environment variables sanitized (API keys, tokens, secrets blocked)
• Rate limiting on input
• Sessions isolated per user via Cloudflare Access

Requirements

• Python 3.12+
• uv is prefered
• cloudflared (auto-installed if missing)

License

AGPL-3.0