Skip to content

README.md

Latest commit

 

History

History
117 lines (85 loc) · 2.7 KB

README.md

File metadata and controls

117 lines (85 loc) · 2.7 KB
Raw

Claude Mobile Setup

iPhone-optimized remote access to Claude Code via Termius + Mosh + tmux.

Features

  • Mosh - Survives network drops (WiFi→cellular, tunnels, sleep/wake)
  • Session Picker - Quick selection of active Claude sessions on connect
  • Voice Input - Speak prompts via Termius speech-to-text
  • Single Window - Optimized for iPhone screen
  • Shift+Tab - Native support in Termius for Claude's approval workflow

Prerequisites

Installation

git clone https://github.com/YOUR_USERNAME/claude-mobile-setup.git
cd claude-mobile-setup
./install.sh

What Gets Installed

File Location Purpose
claude-picker ~/bin/ Session selector (runs on connect)
claude-session ~/bin/ Create new Claude sessions
claude-attach ~/bin/ Attach to existing session
tmux.conf ~/.tmux.conf Mobile-optimized tmux config

Quick Start

On Mac:

# Start a session for your project
claude-session myproject ~/projects/myapp

# Detach: Ctrl-A then d

On iPhone:

  1. Open Termius
  2. Connect to your Mac host
  3. Select session from picker
  4. Code with voice!

Termius Setup

See TERMIUS_SETUP_QUICK_GUIDE.md for detailed iPhone setup instructions.

Quick config:

  • Mosh: ON
  • Startup command: claude-picker

Architecture

iPhone (Termius)
    │
    │ Mosh (UDP, survives network drops)
    ▼
Mac (Tailscale IP)
    │
    ├── claude-picker (session selector)
    │       │
    │       ▼
    └── tmux session
            │
            └── Claude Code

Recommended Termius Snippets

Name Content Voice trigger
yes yes "yes"
no no "no"
cont continue "continue"
tests run the tests "run tests"
commit commit these changes "commit"

tmux Cheatsheet

Prefix: Ctrl-A

Action Keys
Detach Ctrl-A → d
Scroll Ctrl-A → [
Reload Ctrl-A → r

Mouse scrolling is enabled.

Troubleshooting

Mosh connection fails

  • Ensure UDP ports 60000-61000 are accessible
  • On restrictive networks, disable Mosh in Termius (falls back to SSH)

Session picker doesn't appear

  • Check Termius startup command is set to claude-picker

Voice input not working

  • Tap microphone icon in Termius keyboard toolbar
  • Grant microphone permission if prompted

License

MIT