A terminal user interface frontend for managing Cloudflare Warp (warp-cli) connections on Linux.

• Linux system
  • Tested and developed on Fedora 43, your experience may differ
• warp-cli
• Python 3.14 or higher (if running from source)

Download the latest release here and install:

$ wget https://github.com/junyali/warp-tui/releases/latest/download/warp-tui
$  sudo install -m 755 warp-tui /usr/local/bin

Clone the repository and install dependencies:

$ git clone https://github.com/junyali/warp-tui.git
$  cd warp-tui
$  pip install -r requirements.txt

Build the binary with Pyinstaller

$ pyinstaller warp-tui.spec

The binary will be in the dist/ directory. Install it:

$ sudo install -m 755 warp-tui /usr/local/bin

Just run:

$ warp-tui

⚠️ Warning: First time users of warp-cli MUST register their device with Cloudflare WARP. You can do so by running the following command:

$ warp-cli registration new

and verify it has registered successfully:

$ warp-cli registration status

• Use arrow keys just like any other TUI to navigate menus
• Press Enter to select an option
• Press Escape to go back
• Press 'q' to quit

• Connect and disconnect from WARP
• View connection status through polling
• Change WARP mode (warp, doh, warp+doh, dot, warp+dot, proxy, tunnel_only)
• Configure proxy port (when using proxy mode)