moshterm

~ claude code

Claude Code from your phone

To use Claude Code from your phone, run it in tmux on your computer, install the moshterm companion there, and connect with moshterm on iPhone, iPad or Android. Its permission prompts reach your lock screen with the command it wants to run. Approve or deny them, or read the session as a chat. All of it is free.

App Store coming soon Get it on Google Play

Free, no account. moshterm Pro adds live previews.

Set it up

On the computer where Claude Code runs (macOS, Linux or WSL):

# installs moshterm-hook and starts itcurl -fsSL https://mickmosh-relay.mick-fb5.workers.dev/install.sh | sh
# adds moshterm's hooks to ~/.claude/settings.json; yours staymoshterm-hook install

Start Claude Code inside a tmux session, as you normally would:

# a session for the agenttmux new -s api
# inside that sessionclaude

Then connect from the phone. The app pairs with the companion on that first connection; there is nothing to copy. If the companion isn't installed yet, the app offers to install it for you.

Approvals on the lock screen

When Claude Code stops to ask permission, the companion sends the request to your phone with the command or the files involved. Deny works right from the notification. Approve asks you to unlock first.

Your answer is typed into Claude Code's own dialog, but only after the companion checks that the dialog in the tmux pane is still the one you saw. If it changed, nothing is typed and the phone tells you. When Claude Code isn't in a tmux pane, the request shows Answer in terminal and takes you to the session.

Chat View and the Inbox

Chat View reads Claude Code's transcript on your computer and shows the session as a conversation: your prompts, its replies, and each tool call folded to one line. A prompt you send from Chat View goes to the same pane. Close it and the terminal is where you left it.

The Inbox lists every Claude Code session on every paired computer under Needs you, Working and Done. On iPhone, a working session also sits on the Lock Screen as a Live Activity.

Where things run

Claude Code runs on your computer with your own login, exactly as it does at your desk. moshterm is the terminal and the notifications. What you type and see goes straight between your phone and your computer, never through moshterm's servers.

Questions

Can I approve Claude Code permission prompts from my phone?

Yes. With the moshterm companion installed and Claude Code running in a tmux pane, each permission prompt reaches your phone. Approve or deny it from the notification or the Inbox, and the companion types the answer into Claude Code after checking the prompt hasn't changed.

Does Claude Code run on the phone?

No. It runs on your own computer as usual. moshterm connects to that computer over Mosh, Eternal Terminal or SSH.

Is it free?

Yes. Approvals, the Inbox, Chat View and notifications are free, with no limit and no account. moshterm Pro only adds live previews of dev servers and simulators.