CodeSail CLI

Control Claude Code sessions from your terminal and pair with the CodeSail iOS app.

Install

npm install -g codesail

Requires Node.js 20+.

Quick Start

# Create an account (first time only)
codesail login

# Or pair with an existing CodeSail mobile app
codesail auth login
# → Scan the QR code with the CodeSail iOS app

Once paired, any Claude Code session you start will appear in the CodeSail app on your phone — letting you monitor, send messages, and approve permissions on the go.

Commands

Account

| Command | Description | |---------|-------------| | codesail login | Create a new account or show QR for mobile pairing | | codesail auth login | Display QR code for the mobile app to scan and pair | | codesail backup show | Display your backup key | | codesail backup restore | Restore an account from a backup key |

Sessions

| Command | Description | |---------|-------------| | codesail sessions | List active Claude Code sessions | | codesail send <session> <message> | Send a message to a session | | codesail approve <session> | Approve a pending permission request | | codesail deny <session> | Deny a pending permission request |

Daemon

The daemon runs in the background to keep your sessions synced with the relay server. The CodeSail iOS app can also spawn new sessions through it.

| Command | Description | |---------|-------------| | codesail daemon start | Start the background daemon | | codesail daemon stop | Stop the background daemon | | codesail daemon status | Show daemon status |

Config

| Command | Description | |---------|-------------| | codesail config set <key> <value> | Set a config value | | codesail config get <key> | Get a config value | | codesail config list | List all config values |

How It Works

CodeSail connects to a relay server that bridges your Claude Code sessions with the iOS app. All messages are end-to-end encrypted using NaCl (for legacy sessions) or AES-256-GCM (for newer sessions). The relay server never sees your plaintext.

Configuration

Config is stored in ~/.codesail/:

• credentials.json — account keys and auth token
• config.json — server URL and preferences
• daemon.state.json — daemon process info

License

MIT