Docs

Get started

About ten minutes: install mobd on the computer that does the work, tell it which agents to run, then pair your laptop or phone.

What you need

An office computer that stays on and online, running mobd:
- macOS 13 or later on Apple Silicon, with a user logged in.
- Linux: Ubuntu 22.04 or 24.04, or Debian 12 or 13, on amd64 or arm64. A server or VM without a screen is fine. Other distributions build mobd from source.
- Windows is planned.
An agent installed and set up on it (its account or an API key): Codex, Claude Code or Pi, or several.
A device with Mob: Mob Desktop for macOS (Windows and Linux on the way), or Mob Mobile for iPhone and iPad (iOS 17+) or Android 8.0+.
A way for the device to reach the computer: the same network or VPN, or remote access through Tailscale or Cloudflare.

Mob works the same from your devices either way. On the office computer the two differ in how the agent gets a screen:

	macOS	Linux
The agent's screen	the Mac's own screen, shared by all conversations	a virtual desktop per conversation
Turns at once	one; the others wait in a queue	up to four, side by side (`maxRunning`)
Permissions	Screen Recording and Accessibility	none
Runs as	a LaunchAgent of the logged-in user	a systemd user service; no login needed
Live view	the Mac's screen	the open conversation's desktop

Install mobd: on macOS or on Linux. Each guide ends with mobd running and checked.
Configure agents: choose Codex, Claude Code and Pi, and the folder they work in.
Pair a device: run mobd link and scan the code in Mob.
Optional, remote access: reach the office computer from anywhere.

Then start a conversation and try something simple, such as “Look at the screen and tell me what you see.” Stuck? See FAQ & help.