Guides
Away from the desk
Mucq on iPhone and iPad is the whole app, on the same tmux sessions as any other device. Answer Claude from the couch, then pick it up anywhere.
On this page
The same sessions
Mucq on iPhone and iPad opens a project exactly as the Mac does: same server, same tmux session, same Claude. Nothing is copied or synced; there's one session on the server, and each device is another window into it.
Add your servers on each device once. Each device makes its own key, so the server needs each one in ~/.ssh/authorized_keys: Copy Install Command on the device gives you the line to run.
The size follows you
A tmux session shared by a Mac and an iPhone can only have one size. Mucq makes it follow the device you're using: use the session on the iPhone and it fits the iPhone; click back into the Mac window and it fits the Mac.
That's Fit shared sessions to the Mucq window in front in Settings › Sessions on the Mac, and Fit shared sessions to the Mucq you're using on iPhone and iPad. It's on by default. A Mucq that was already connected when you turned it on needs one reconnect.
Steering from the phone
Claude Code asks for a handful of keys a phone keyboard doesn't have. On iPhone, while the keyboard is down, a steering bar at the bottom of the terminal has them: esc, tab, the up and down arrows and return, plus a button for files and one for the keyboard. With the keyboard up, a row above it carries esc, ctrl, tab, ⇧tab, the arrows, ⇧↩ for a new line, ⌃C and more, on iPhone and iPad alike.
Every key and what it sends is in Steering keys.
Files and photos
The paperclip, Send files, offers Send Photos… and Send Files…. Pasting works too. Mucq uploads the file to the server and pastes its path into Claude's prompt, without pressing Return, so you can say what to do with it.
- Files land in
~/.cache/mucq/uploads/on the server, outside every project, readable only by you. Each upload also clears out the ones older than 30 days. - Mucq pastes into Claude's prompt only while Claude is Idle, Working or Done. While Claude waits for an answer, Mucq doesn't type over the question; it offers Copy Path instead.
- Anything above 100 MB asks first. Folders aren't sent.
Lock the phone, lose the signal
The session lives in tmux on your server, not on the phone. Lock the phone, switch apps, lose the signal in a tunnel: Claude carries on.
In the background, iOS suspends Mucq, and Mucq stops checking states. When you come back, it reconnects, keeps the last screen in place while it does, and you're where you left off. Or pick it up on the Mac; the session is the same.
Which project needs you
The list says it in words, project by project. On iPhone and iPad, the next-needing-attention button in the terminal's toolbar jumps to the next project that needs you. On iPad with a keyboard, so does ⇧⌘U, as on the Mac. And you don't have to look: lock the phone, and Mucq tells you when Claude needs you or is done. How that works is in Notifications.