Getting Started

Get MobileCLI up and running in just a few minutes. This guide covers installation, initial setup, and connecting your first device.

Prerequisites

Before installing MobileCLI, ensure you have:

An AI coding CLI (Claude Code, Gemini CLI, Codex, or OpenCode) installed on your desktop
An iPhone or iPad with the MobileCLI iOS app. Android support is being validated separately before public distribution.
Network connectivity (local network or Tailscale for remote access)

Installation

1. Install MobileCLI

Install MobileCLI using the macOS/Linux install script, Cargo, or a Windows release archive. The install script downloads `SHA256SUMS.txt` from the GitHub Release and verifies the archive before extraction:

 # macOS/Linux

curl -fsSL https://mobilecli.app/install.sh | bash

 # Windows or cross-platform Cargo install

cargo install mobilecli
 # Windows prebuilt zip: GitHub Releases

2. Run Setup

Run the setup command to auto-detect your installed AI CLIs and configure your environment:


mobilecli setup

3. Launch MobileCLI

Start the daemon with mobilecli or mobilecli setup to begin.

First Run Setup

Run mobilecli setup to walk through the initial configuration:

Auto-Detect CLIs

Run mobilecli setup — it auto-detects installed CLIs (Claude Code, Gemini CLI, Codex, OpenCode).

Server Starts

The server starts on port 9847 and a QR code is displayed in your terminal.

Pair Your Mobile App

Scan the QR code with the MobileCLI mobile app. The QR includes the daemon URL, device metadata, credential id, server id, and a one-time pairing token; keep the daemon reachable only from a trusted network path.