Setup Guide

Get started with CodeSail

From install to first session in under five minutes.

01

Download the iOS App

Get CodeSail from the App Store on your iPhone. Requires iOS 17.0 or later.

Download on the App Store
02

Install the CLI

Install the CodeSail CLI globally via npm. This connects your terminal to the iOS app.

Terminal 
npm install -g codesail

Requires Node.js 18 or later. Check your version with node --version

03

Start the Daemon

The daemon runs in the background and bridges your Claude Code sessions to the iOS app.

Terminal 
codesail daemon

The daemon starts automatically after pairing. You can also run codesail daemon --background to keep it running in the background.

04

Pair Your Device

Generate a pairing QR code in your terminal and scan it with the CodeSail app. This creates an encrypted connection between your devices — no account needed.

Terminal 
codesail pair

Then open the CodeSail app on your iPhone:

  1. Tap Add Computer
  2. Scan the QR code displayed in your terminal
  3. Or tap Enter Code Manually to type the pairing code
05

Start a Session

Start Claude Code as you normally would. CodeSail automatically detects active sessions and shows them in the app.

Terminal 
claude

Your session will appear in the CodeSail app within seconds. From there you can monitor the conversation, approve permissions, browse files, and more.

06

SSH Remote Setup Optional

Connect to Claude Code sessions running on remote servers. CodeSail can tunnel through SSH to reach your dev machines.

Terminal — Remote Server 
# On your remote server
npm install -g codesail
codesail pair

Install and pair on each remote machine separately. Each server appears as a separate computer in the app.

That's it. You're all set.

Download CodeSail and start controlling Claude Code from your iPhone.

Download on the App Store