Set up Commission for Claude Code
Commission has two parts: a hub that runs on one Mac, and the apps you use to reach it. Set up the hub once, connect your phone, and add other machines whenever you want to. It takes about ten minutes if Claude Code and Tailscale are already on your Mac.
What you need
claude once to sign in, on every machine you'll
use.
What goes where
| Part | Runs on | What you install |
|---|---|---|
| The hub (one) | A Mac with macOS 13.5 or later, or a Linux machine | The Mac app (macOS 14 or later) or the one-line installer |
| Your other machines | Macs, Linux machines and Windows PCs (early) the hub reaches over SSH | Nothing by hand: the hub installs itself there as you |
| iPhone | The Commission app, in a private beta, or Safari | Tailscale, and the app if you're in the beta |
| Android, iPad, other computers | Any browser on your tailnet; no push notifications | Tailscale |
Claude Code runs on the machines, signed in to your own account. Your phone and browser only show and steer it.
1. Install the hub
On a Mac, the easiest way is Commission for Mac (macOS 14 or later): open it and it checks this Mac, installs the hub and shows the QR code for your phone.
Or paste this into Terminal on the Mac or Linux machine that will be your hub:
curl -fsSL https://commission.sh/install | sh
It checks for Claude Code and Tailscale, installs the hub as a background service that
runs as you, never asks for an admin password, and starts again whenever you log in.
You'll get a commission command for everything else.
Read the script before you run it.
When it asks, let it publish the hub to your tailnet with Tailscale Serve. That's how your phone reaches it, and only devices on your tailnet can.
First time using Tailscale Serve? If it isn't turned on for your tailnet yet,
Tailscale's message includes a link to turn it on. Follow it, then run
tailscale serve --bg 4317 or commission doctor.
2. Connect your iPhone
- Install Tailscale on your iPhone, signed in to the same tailnet as your Mac, and the Commission app from TestFlight if you're in the beta.
-
In the Mac app, or at
http://127.0.0.1:4317in a browser on the hub, open Settings and choose Connect phone. - Scan the QR code with your iPhone's camera, or tap Scan QR code in the app. You can also type the address shown under it.
The iPhone app is in a private beta while Commission is in beta. Without it, open the address under the QR code in Safari on your iPhone: it's the same app, without push notifications. More on Claude Code from your iPhone.
3. Approve Claude's first command
- On the phone, tap the new session button, pick a machine and a folder, and ask for something that runs a command, such as "run the tests".
- When Claude asks to run it, a notification shows the exact command. Press and hold it and choose Allow once, which asks for Face ID, or Deny.
Sessions you already have in a terminal on your machines are in the list too, and what you type there shows up live. In a browser, approvals appear in the session and at the top of Activity instead of as notifications.
4. Add more machines
This step is optional: one machine is enough, and you can add others at any time. Any
Mac, Linux machine or Windows PC your hub can reach over SSH with a key, and that has
Claude Code signed in. In Commission, go to
Machines → Add machine, or pick a device from
On your tailnet, not in Commission, and enter something like
you@server. Or from the terminal:
commission machine add you@server.your-tailnet.ts.net
Commission shows you what it will install and the machine's SSH fingerprint, and asks once. It installs as your user there and connects back through SSH. Machines you reach with Tailscale SSH work the same way. Windows works too, though its setup is still rough. More in the Linux server guide.
5. Spaces, Linear, Jira and Slack
Spaces keep each part of your work together, whichever machines it runs on. Choose New space in the sidebar, give it a name and the machine (and folder) it starts on.
To work from your issues, open Machines, pick a machine, open its Integrations tab and choose Add integration. Linear takes a personal API key; Jira takes your Cloud site, Atlassian email and an API token. Either stays on that machine. Tie a connection to spaces to see its issues there first.
Slack works in the Mac app only: add your workspace's address under Add integration → Slack, then press ⌘S and sign in to Slack inside Commission. No token is needed. More on Slack and your web apps, and on Linear, Jira and GitHub.
Updates and uninstalling
When a new version is out, Commission shows
Update available; your other machines follow with one tap on
Update all. From the terminal, run commission update.
To remove the hub, run commission host uninstall. Your Claude Code
conversations aren't touched.
The first time you open Commission, it tells you about its anonymous usage data: a few counts per day, never your prompts, code or names. Nothing is sent before that notice, and one switch in Settings turns it off. What's collected.
If something goes wrong
claude in a terminal on that machine, sign in, then try
again.
commission doctor. It checks every part of the setup and tells you
how to fix what it finds.