Last updated: 2026-05-28

User Guide

The core concept of HiTerm is the tmux session — your unit of work. PC and phone are two entry points. Switch anytime, resume anywhere.

Two most common workflows:

  1. Start on PC, continue on phone — Let your agent run before you leave, review on the go
  2. Start on phone, continue on PC — Catch an idea on the subway, pick it up at your desk

Scenario 1: Start on PC, Continue on Phone

You're at your PC. An AI agent is writing code or running a build. You need to leave before it finishes.

PC — Create a Named Session, Start the Task

# Create a session with a project name
tmux new -A -s claude-frontend

# Start the AI agent inside the session
claude

The -A flag means: attach if the session exists, create it if it doesn't. Safe to run repeatedly.

Naming matters — the phone identifies sessions by name. Use tool-project format, e.g. gemini-backend, codex-api.

PC — Walk Away

The agent is running. You can leave. The tmux session stays alive regardless of network status or SSH connections.

Phone — Connect After You Leave

  1. Open the Hi Term app
  2. Tap your PC in the host list
  3. You're in the tmux session — see exactly what the agent is doing

Phone — Review Output, Give New Instructions

When the agent finishes, you can:

  • Scroll up to see output history
  • Double-tap to open the shortcuts panel, tap Ctrl+C to interrupt, tap /compact to compress context
  • Type directly to give the agent new instructions

Phone — Get Notified

If your AI tool has the hiterm notify hook configured (hiterm pair auto-configures Claude Code, Gemini CLI, and Codex), your phone buzzes when the agent finishes. Tap the notification to jump straight back to the session.

Tip: Long tasks survive network drops. Subway tunnels, WiFi-to-4G handoff, even closing the app — the tmux session stays alive on your PC. Just reconnect.

Scenario 2: Start on Phone, Continue on PC

You're on the subway. An idea hits. You want to experiment right now — no need to go back to your desk.

Phone — Create a Session, Start Working

  1. Open Hi Term, connect to your PC
  2. Create a new session in the terminal:
tmux new -A -s claude-experiment
  1. Start working — write code, run commands, launch an AI agent

Everything you do on the phone runs on the PC. The phone is just a screen.

Phone — Put It Down Anytime

Need to get off the train? Just close the app. The session lives on the PC. Nothing is lost.

PC — Back at Your Desk, Pick Up

Open your terminal:

# See what sessions are running
tmux ls

# Attach to the one you created on your phone
tmux new -A -s claude-experiment

The half-written code, running commands, agent conversation — all there. Seamless.

Phone Operations

After connecting to your PC, everything is gesture-based — see Phone Operations.

Next Steps