Getting started
What you need
A server you can reach over SSH, tmux and Claude Code on it, and a Mac, iPhone or iPad on your side. Nothing else.
On this page
On your side
Any of these:
- A Mac with macOS 26 or later.
- An iPhone with iOS 26 or later.
- An iPad with iPadOS 26 or later.
Mucq runs on Mac, iPhone and iPad, each a complete app on its own that connects to your servers over SSH. Use one, or all three on the same sessions.
The server
Anything you can reach over SSH:
- A Linux server, such as Ubuntu or Debian: a VPS, or a box under the desk. This is the usual case, and the Linux guide walks through it.
- A Mac, through Remote Login. That can be the Mac you're on: see Use your Mac as the server.
Its SSH server needs an Ed25519 or ECDSA host key and AES-GCM encryption. OpenSSH sets up both by default, so a standard install is fine. The details are in SSH support.
On the server
- tmux. Your sessions live there, so they outlast every disconnect, dead battery and tunnel. Mucq runs
tmuxthrough a plain SSH command, so it has to be on that command'sPATH. A package install (apt install tmux) is. - Claude Code, installed and signed in. Mucq starts it in a login shell inside tmux, so wherever your login finds
claude, Mucq finds it too.
If Claude Code isn't signed in yet, it asks in the terminal the first time, and the project reads Needs you until you answer.
For notifications on iPhone and iPad, the server also needs curl, sha256sum or shasum, and outbound HTTPS. Mucq installs a small script there itself.
Note
If your login shell is fish, it needs fish 3.4 or later. Bash, zsh and sh work as they are.
What you don't need
No agent, no daemon and no account. Nothing of Mucq's keeps running on the server: it starts Claude Code with settings that include hooks, and through those hooks Claude reports its own state to the tmux session Mucq reads.
How you log in
By key or by password:
- A key. Mucq makes one in each device's Secure Enclave, where it can't be copied out. You can also import an Ed25519 or ECDSA key of your own.
- A password, kept in the Keychain if you want.
RSA keys and keyboard-interactive logins aren't supported. Next: add your first server.