Guides
Use your Mac as the server
Claude Code on the Mac you're sitting at, with Mucq connecting to it over SSH like any other server, from your Mac, iPhone or iPad.
On this page
Mucq from the App Store connects to servers over SSH, and a Mac is a fine server. Turn on Remote Login, and Mucq treats the Mac you're on exactly like a machine across the internet: its own tmux sessions, Claude in each project folder, and the same sessions on your iPhone and iPad.
An honest note
This treats your Mac like any remote server, reached over SSH. Sessions on This Mac, with its own files at hand, are a Mucq Pro feature. Mucq Pro comes later as a separate Mac app with its own price; for iPhone and iPad you'd still need Mucq from the App Store, bought separately.
1. Turn on Remote Login
In System Settings › General › Sharing, turn on Remote Login. Set Allow access for to your own account only.
2. tmux and Claude Code
Install tmux with Homebrew, and Claude Code the way Anthropic's setup guide describes:
brew install tmux
macOS gives commands that arrive over SSH a short PATH (/usr/bin:/bin:/usr/sbin:/sbin), which doesn't include Homebrew. Add Homebrew to ~/.zshenv, which every zsh reads, so Mucq finds tmux:
echo 'eval "$(/opt/homebrew/bin/brew shellenv)"' >> ~/.zshenv
On an Intel Mac, Homebrew lives in /usr/local/bin/brew instead. Claude itself is found once tmux runs, because tmux starts a login shell.
3. Add the Mac to Mucq
Add a server with Host localhost, your Mac username as User, and Sign in with SSH Key. Choose Copy Install Command, paste it into Terminal and press Return: it adds Mucq's key to your ~/.ssh/authorized_keys.
Open a project of localhost and confirm its host key once. Your Mac's fingerprint is one command away:
ssh-keygen -lf /etc/ssh/ssh_host_ed25519_key.pub
4. Keys only
Remote Login opens SSH on this Mac to the network, so allow keys only. A file of your own in /etc/ssh/sshd_config.d/ stays in place when a macOS update replaces /etc/ssh/sshd_config:
printf 'PasswordAuthentication no\nKbdInteractiveAuthentication no\n' | sudo tee /etc/ssh/sshd_config.d/010-key-logins.conf
sudo sshd -t
sudo sshd -t prints nothing when the configuration is valid. Check it: this login should now end with "Permission denied (publickey)", while Mucq still connects with its key.
ssh -o PubkeyAuthentication=no localhost
To undo it, delete the file again: sudo rm /etc/ssh/sshd_config.d/010-key-logins.conf.
5. iPhone and iPad
Your iPhone and iPad reach the same Mac over your network. Add it as a server there too, with the Mac's local hostname as Host. System Settings › General › Sharing shows it at the bottom, something like your-mac.local.
- The first time, iOS asks whether Mucq may find devices on your local network. Allow it; without it, Mucq says No local network access and offers to open Settings.
- Each device has its own key. Choose Copy Install Command on the iPhone and paste it into Terminal on the Mac (Universal Clipboard carries it across), or send the key over with Share Public Key… and add it yourself.
Outside your home network, the local name doesn't reach the Mac. Tailscale does.
A Mac that's asleep answers nobody. If you work from the couch while the Mac sits in the study, keep it from sleeping.