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

A Mac that stays onmacOS 13.5 or later, or 14 for the Mac app. This is your hub; your sessions are only reachable while it's awake.
Claude Code, signed inInstall it and run claude once to sign in, on every machine you'll use.
Tailscale on the Mac and iPhoneBoth signed in to the same tailnet. It's free for personal 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

  1. Install Tailscale on your iPhone, signed in to the same tailnet as your Mac, and the Commission app if you're in the beta.
  2. In the Mac app, or at http://127.0.0.1:4317 in a browser on the hub, open Settings and choose Connect phone.
  3. 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

  1. 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".
  2. 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

The phone can't reach the hubCheck Tailscale is on in the iPhone's VPN settings and signed in to the same tailnet as the Mac, and that the Mac is awake.
"Claude Code isn't signed in"Run claude in a terminal on that machine, sign in, then try again.
Anything elseRun commission doctor. It checks every part of the setup and tells you how to fix what it finds.

Next: put it to work