Last updated: 2026-05-25

Quick Start

Get started in 5 minutes. Turn your phone into a mobile terminal.

Before You Begin

  • Tailscale installed on PC โ€” Not yet? See Tailscale Setup
  • Tailscale installed on phone โ€” Get it from Google Play
  • Same Tailscale account on both devices

Steps

Step 1: Install hiterm

curl -fsSL https://hiterm.yinbin.ink/install.sh | bash

China users: The installer auto-detects network and uses a local mirror.

Step 2: Run pair

hiterm pair

This command:

  • Checks Tailscale, sshd, mosh, tmux
  • Shows install commands if anything is missing
  • Generates a QR code for your phone

Step 3: Install the app

Download the APK from https://hiterm.yinbin.ink/download.

See Android Installation for detailed setup steps.

Step 4: Scan the QR code

  1. Open Hi Term app on your phone
  2. Tap the scan button ๐Ÿ“ท
  3. Scan the QR code from hiterm pair
  4. Pairing completes in ~3 seconds

Step 5: Connect

  1. Tap the โ˜ฐ menu (top-right corner) โ†’ your PC appears โ†’ tap it
  2. Wait ~5 seconds for connection
  3. Type ls to test

Done. You can now access your PC's terminal from anywhere.

Next Steps

Try notifications (requires login)

hiterm login
hiterm notify test

Your phone should receive a test notification.

Learn the basics

Recommended: name your tmux sessions

tmux new -A -s backend-gemini
tmux new -A -s frontend-claude

Named sessions appear as tabs in the app for quick switching.

Your mobile terminal is ready. ๐Ÿš€