Skip to content

Getting started

Add your first server

Host, user, key or password. Then one look at the server's fingerprint, and you're in.

On this page

The first time you open Mucq, it asks for the server where Claude runs. Choose Add Server… to begin; later, the same command is in the File menu (⌘N).

The server

FieldWhat goes in
HostThe server's name or IP address, such as devbox.example.com.
Port22 unless your server listens elsewhere.
UserThe account Claude runs as. On the Mac it starts as your Mac's username.
NameWhat the sidebar calls it. Leave it empty and Mucq uses the host.

Mucq has no ~/.ssh/config, so put the real host, port and user here, not a Host alias.

Sign in with a key or a password

Sign in with offers SSH Key and Password.

SSH Key

The default is Device Key: a key Mucq makes in this device's Secure Enclave the first time you need one. Its private half never leaves the chip, so there's nothing to copy, back up or lose.

The server has to know the key once. Under the key, choose Copy Install Command, then run it in a shell on the server, through an SSH session you already have or your provider's web console. The command adds the key to ~/.ssh/authorized_keys and sets the permissions sshd expects:

Shell
mkdir -p ~/.ssh && chmod 700 ~/.ssh && printf '\n%s\n' 'ecdsa-sha2-nistp256 AAAA… mucq@mac-20261112' >> ~/.ssh/authorized_keys && chmod 600 ~/.ssh/authorized_keys

Yours carries your device's real key. The comment at the end says which device made it and when. Copy Public Key copies just the key line, if you'd rather add it yourself; on iPhone and iPad, Share Public Key… sends it on.

Each device has its own key. Your iPhone's key is not your Mac's, so add each device's key to the server once.

Tip

Already have an Ed25519 or ECDSA key the server trusts? Import it in the key menu instead. RSA keys can't be used.

Password

Choose Password. With Remember password in Keychain on (the default), Mucq asks once and keeps it in your Keychain. Turn it off, and Mucq asks for every new connection.

The projects folder

Projects folder is the folder on the server that holds your projects, such as ~/projects. Every folder inside it becomes a project you can pin to the sidebar.

The first connection

Choose Add Server, and Mucq opens Pin Projects to list the folders on the server. That's the first connection, so Mucq asks first:

Connect to devbox?

Mucq hasn't connected to devbox.example.com before.

Its ED25519 key fingerprint is SHA256:…

Check it before you choose Connect. On the server, this prints the same fingerprint:

Shell
ssh-keygen -lf /etc/ssh/ssh_host_ed25519_key.pub

If the dialog names an ECDSA key, read ssh_host_ecdsa_key.pub instead. When they match, connect. Mucq remembers the key and checks it on every connection after this one. If it ever changes, Mucq won't connect until you say so: see Host key changed.

Then pin the folders you work in and choose Save. Next: your first session.