← Back to Docs

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
  • A mobile device (iOS 15+ or Android 8+) or secondary desktop
  • Network connectivity (local network or Tailscale for remote access)

Installation

1. Install MobileCLI

Install MobileCLI using the install script (recommended) or via Cargo:

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

# Alternative: install via Cargo
cargo install mobilecli

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:

1

Auto-Detect CLIs

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

2

Server Starts

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

3

Pair Your Mobile App

Scan the QR code with the MobileCLI mobile app to pair your device securely.