Skip to content

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 tmux through a plain SSH command, so it has to be on that command's PATH. 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.