@local/dsh-pi-ui

🚀 Quick Start & Usage

Starting the Server

pi-web-ui                                 # Starts in current folder, opens http://127.0.0.1:8787
pi-web-ui --port 9000 --cwd /path/to/repo # Specify port and workspace path
pi-web-ui --no-browser                    # Start server without auto-opening a browser tab

🌐 Opening Remote SSH Server Projects

You can develop on remote servers through two simple ways:

1. From Web UI: In the top-bar workspace dropdown, click "Switch Directory" → select the "Remote (SSH)" tab, fill in the host (e.g. 192.168.1.100), port, username, and password or SSH private key, then click "Connect & Probe". Browse and pick any remote folder. Profiles are encrypted and saved locally for one-click reconnection.
2. From Command Line:

   pi-web-ui --cwd ssh://ubuntu@192.168.1.100:22/var/www/my-project
   

Common Flags & Environment Variables

CLI Flag	Environment Variable	Default	Description
--port	PI_WEB_PORT	8787	HTTP port to listen on
--host	PI_WEB_HOST	127.0.0.1	Listen address (0.0.0.0 for remote/LAN access)
--cwd	PI_WEB_CWD	Current directory	Workspace root (local path or ssh://user@host:port/path)
--data-dir	PI_WEB_DATA_DIR	~/.pi-web	Directory for state, plugins, themes, and uploads
`--engine
`	PI_WEB_ENGINE	pi	Agent engine: pi native or dsh (DeepSeek Harness)
--no-browser	—	off	Do not auto-launch system browser on startup
Env only	PI_WEB_TOKEN	empty	Optional shared authentication token
Env only	PI_WEB_SDK	global	Auto-follow newer pi SDK on ancestor path; set to bundled to pin built-in

System Background Service (pi-web-ui server)

Manage pi-web-ui as a background daemon with auto-start on boot (launchd on macOS, systemd on Linux, Windows Run key):

pi-web-ui server install --port 9000 --cwd /path/to/project  # Install and start background service
pi-web-ui server status                                    # Inspect live status, PID, and connections
pi-web-ui server restart                                   # Restart background server
pi-web-ui server stop                                      # Stop background server
pi-web-ui server uninstall                                 # Remove system service

FRP Reverse Proxy Tunnel (pi-web-ui frp / piwebui frp)

Automatically deploy and configure FRP (Fast Reverse Proxy) to forward your local pi-web-ui port to a remote server with a public IP:

pi-web-ui frp                                              # Interactive setup wizard
pi-web-ui frp deploy --server  --remote-port 8787      # Auto-deploy remote frps and local frpc
pi-web-ui frp status                                       # Check client status and public URL
pi-web-ui frp start|stop|restart                           # Manage local frpc service
pi-web-ui frp run                                          # Run frpc in foreground with live logs
pi-web-ui frp script --server                          # Generate standalone remote deploy bash script

Updating & Uninstalling