Docs
How to run Mucq well. A server, tmux, Claude Code and Mucq. That's the setup; these pages are the details.
On this page
Mucq connects your Mac, iPhone and iPad straight to your own servers over SSH. Claude Code runs there, in tmux, one session per project. Your sessions never pass through anything of ours: no account, no agent on the server.
Getting started
- What you need: the server, the tools on it, and the devices.
- Add your first server: host, user, key or password, and the host-key check.
- Your first session: open a project and Claude starts in its folder.
Guides
Opinionated, on purpose. This is how we'd set it up.
- Set up a Linux server: the usual case, Ubuntu or Debian.
- Use your Mac as the server: Remote Login on the Mac you're on.
- Reaching your server: Tailscale, your own WireGuard, or a public VPS.
- Away from the desk: iPhone and iPad, with or without a Mac, on the same sessions.
- Notifications: when Mucq tells you, on which device, and what it needs on the server.
- Keys and trust: the Secure Enclave key, passwords and host keys.
- tmux: what Mucq sets up, and what to leave alone.
Reference
- Project states: every state word and what it means.
- Steering keys: the keys above the iPhone and iPad keyboard.
- SSH support: keys, logins and algorithms.