Tactic Remote

Control Claude Code from your iPhone or iPad

Website • Documentation • Support

Now on the App Store worldwide. v1.6 is our biggest release — Chat Mode, iPad optimization, App Lock, Cloud STT, file uploads, Git workspace, and much more. Mainland China will follow once regulatory approval is complete.

Overview

Tactic Remote brings the power of Claude Code to your iPhone or iPad. Interact with your coding sessions from anywhere — whether you're on the couch, in a meeting, or away from your desk.

Perfect for reviewing code, monitoring long-running tasks, or quick iterations without being tied to your Mac.

Features

How It Works

┌──────────────────────────────────────────────────────────────────────────┐
│                                                                          │
│   ┌─────────────────┐            WebSocket            ┌─────────────────┐│
│   │   iOS Device    │                                 │   Mac / Linux   ││
│   │                 │  ◄─────────────────────────►    │                 ││
│   │  Tactic Remote  │    ws://local or wss://         │  Server (Node)  ││
│   │      App        │                                 │                 ││
│   └─────────────────┘                                 └────────┬────────┘│
│                                                                │         │
│                                                                ▼         │
│                                                       ┌─────────────────┐│
│                                                       │  Claude Code    ││
│                                                       │     CLI         ││
│                                                       └─────────────────┘│
│                                                                          │
└──────────────────────────────────────────────────────────────────────────┘

Three ways to run the server:

Quick Start

The fastest way to get started — one command, no install:

npx tacticremote

Scan the QR code with the Tactic Remote iOS app and you're connected.

Options

npx tacticremote [options]

  -p, --port <n>      Port to listen on          (default: 8765)
  --path <dir>        Allowed base directory      (default: $HOME)
  --api-key <key>     Require authentication key
  --tunnel            Enable Cloudflare tunnel for remote access
  --no-qr             Don't show QR code
  -h, --help          Show this help

Alternative: Mac Menu Bar App

If you prefer a graphical interface:

1. Download the DMG from Releases
2. Install — open the DMG and drag Tactic Remote to Applications
3. Launch — open from Applications, a menu bar icon will appear
4. Setup — the app will auto-install dependencies (Homebrew, Node.js, tmux) if needed
5. Start Server — click the menu bar icon → Start Server
6. Connect — open Tactic Remote on your iPhone, scan the QR code or enter the IP shown in the menu bar

The Mac app also provides:

• One-click Cloudflare tunnel for remote access
• Live client count and session monitoring
• Copy server URL / tunnel address / API key from the menu
• Language switcher (8 languages)
• Auto-start on login

Download

iOS App iPhone / iPad

Mac App macOS 14+

CLI Mac / Linux npx tacticremote

Requirements

Connection Modes

Local Network (WiFi)

Default mode for home/office use.

ws://192.168.1.x:8765

Ensure your iOS device and Mac are on the same WiFi network.

Public Access (Cloudflare Tunnel)

Connect from anywhere using a secure tunnel — no open ports, no configuration:

npx tacticremote --tunnel

The server generates a wss:// URL automatically. Use this URL in the iOS app.

Security

API Key Authentication (Optional)

npx tacticremote --api-key "your-secure-key"

Then enter the same key in iOS app settings.

Path Restrictions

File operations are restricted to your home directory by default. Customize:

npx tacticremote --path "/Users/yourname/Projects"

Cloudflare Tunnel

Public access uses Cloudflare's secure tunnel with TLS encryption — no open ports on your machine.

Troubleshooting

Cannot connect to server

• Verify Mac and iOS are on the same network
• Check Mac firewall allows connections on port 8765
• Confirm server is running: lsof -i :8765

Connection drops frequently

• Check WiFi stability
• The app supports automatic fallback between LAN and tunnel connections
• iOS app auto-reconnects up to 5 times

Claude not starting

• Ensure Claude Code CLI is installed: claude --version
• Check tmux is installed: tmux -V
• Verify the working directory exists

Documentation

Visit tacticremote.com for:

• Visual setup guides
• Advanced configuration
• Troubleshooting tips
• Release notes

License

This software is proprietary. See LICENSE for details.

Support

• Report Issues
• Discussions
• Website