tactic-remote-server

Server component for Tactic Remote — control Claude Code from your iPhone or iPad.

Quick Start

npx tacticremote

That's it. Scan the QR code with the Tactic Remote iOS app to connect.

Alternative install via Homebrew:

brew install TacticSpaceTech/tap/tacticremote

Prerequisites

• Node.js 16+
• tmux — install with brew install tmux (macOS) or sudo apt install tmux (Linux)
• Claude Code CLI — install from claude.ai/code

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
  --no-bonjour        Disable mDNS discovery
  --no-qr             Don't show QR code
  -v, --version       Show version
  -h, --help          Show this help

Environment Variables

| Variable | Description | |----------|-------------| | PORT | Server port (default: 8765) | | CLAUDE_REMOTE_API_KEY | Authentication key | | CLAUDE_REMOTE_ALLOWED_PATH | Base directory for file operations |

How It Works

iPhone (Tactic Remote app)  <-- WebSocket -->  This server  <-- tmux -->  Claude Code CLI

The server manages tmux sessions running Claude Code and bridges them to the iOS app over WebSocket. All data stays on your local network.

iOS App

Download Tactic Remote from the App Store.

License

MIT