RoamTerm

Run Claude Code from your phone

Last updated:

Long agent runs do not wait for you to sit at your desk. With RoamTerm you open a terminal on the computer where Claude Code is running, see the same session, and answer a prompt or stop a task from your phone.

The simple setup: tmux plus RoamTerm

  1. Install the RoamTerm agent on your computer and pair your phone with the QR code.
  2. Start Claude Code inside a tmux session on the computer:
tmux new -s claude
claude
  1. Leave the desk. On the phone, open RoamTerm, tap your computer and attach to the claude session. The terminal shows exactly what is on your screen, and your keystrokes go to the same session.

tmux keeps the session alive when your phone sleeps or your network changes, and RoamTerm reconnects quietly.

Let Claude Code use your phone (MCP)

RoamTerm also ships an MCP server, so Claude Code can use tools that live on your phone connection. Add it once on the computer:

claude mcp add roamterm -- roamterm mcp

AI access is off by default. You turn it on per device in the app, a banner shows while an agent is connected, and one tap cuts it. An action log shows what the agent did.

Tips for the small screen

  • Use the key row for Esc, Ctrl, Tab and the arrow keys. Claude Code relies on them.
  • Raise the font size in the terminal settings if you are reading long diffs.
  • A tablet with a hardware keyboard gives you a split view of machines and terminal.

Security

Your session is SSH from phone to computer. The relay only pairs the two sides and cannot read the content. See how security works.

Related: tmux on your phone.