Data

Tools

Indexes

Applications

Experiments

Awesome

An open API service indexing awesome lists of open source software.

https://github.com/tacticspacetech/tacticremote

Control Claude Code from your iPhone or iPad — Tactic Remote
https://github.com/tacticspacetech/tacticremote

claude-code ios macos remote-control ssh terminal tmux websocket

Last synced: about 1 month ago
JSON representation

Control Claude Code from your iPhone or iPad — Tactic Remote

Awesome Lists containing this project

README 

          



Tactic Remote



# Tactic Remote



### Control Claude Code, Codex, and Amp from your iPhone or iPad



[![iOS](https://img.shields.io/badge/iOS-16.4%2B-blue.svg?style=flat&logo=apple&logoColor=white)](https://apps.apple.com/us/app/tactic-remote-ai-coding/id6758008464)

[![macOS](https://img.shields.io/badge/macOS-14.6%2B-green.svg?style=flat&logo=apple&logoColor=white)](https://github.com/TacticSpaceTech/TacticRemote/releases)

[![npm](https://img.shields.io/badge/npx-tacticremote-cb3837.svg?style=flat&logo=npm&logoColor=white)](https://www.npmjs.com/package/tacticremote)

[![App Store](https://img.shields.io/badge/App%20Store-Available-purple.svg?style=flat&logo=apple&logoColor=white)](https://apps.apple.com/us/app/tactic-remote-ai-coding/id6758008464)



[Website](https://tacticremote.com) • [Documentation](https://tacticremote.com/docs) • [Support](https://github.com/TacticSpaceTech/TacticRemote/issues)






---



> **Tactic Remote v1.8.0 is now available.** Chat Mode is easier to read, Quick Prompts make repeat workflows faster, mobile Git review helps you inspect changes from your phone, and the Mac companion app is more reliable during long-running sessions.



---



## Overview



Tactic Remote brings AI coding agents to your iPhone or iPad. Run Claude Code, OpenAI Codex, or Sourcegraph Amp on your computer, then monitor output, send prompts, approve blocking steps, review code changes, and keep long-running work moving from your mobile device.



It is built for developers who want to stay close to AI coding sessions without staying at their desk.



---



## What's New in 1.8.0



- **Chat Mode refinements** — Messages, tool activity, Thinking blocks, and streaming output are easier to read on mobile.

- **Quick Prompts Library** — Save reusable review, debugging, testing, and handoff prompts for one-tap reuse.

- **Mobile Git review** — Inspect changed files and per-file diffs from the phone before deciding what the agent should do next.

- **Server compatibility checks** — See server version, protocol version, platform, and supported capabilities more clearly.

- **Mac companion reliability** — Prevent Sleep support helps keep long-running AI coding sessions available, and in-app update checks remain supported.



---



## Features






### **Chat Mode for Agent Output**

Read agent messages, tool calls, Thinking sections, and streaming updates in a mobile-friendly layout



### **Quick Prompts Library**

Save common review, test, debug, and summary prompts so repeat workflows are always close



### **Mobile Git Review**

View changed files, inspect diffs, and decide whether an agent's work should continue



### **Multi-Agent Sessions**

Choose Claude Code, OpenAI Codex, or Sourcegraph Amp when creating a session



### **Git Worktree Workflow**

Group sibling worktrees and switch between parallel implementation branches



### **Smart Prompt Toolbar**

Auto-reveals shortcuts for blocking TUI prompts like confirmations and trust dialogs



### **Terminal Mode**

Full terminal with ANSI color support, real-time streaming, search, and keyboard submit



### **iPad-Optimized Layout**

Native split-view with hardware keyboard shortcuts



### **Cloud Speech-to-Text**

Dictate prompts in 25+ languages



### **File Uploads**

Send files from iOS to the remote server



### **Multi-Session Management**

Create, switch, and delete multiple tmux sessions



### **Remote File Browser**

Browse your Mac's file system and select project directories from iOS



### **Local & Remote Access**

Connect via Wi-Fi or Cloudflare Tunnel, with automatic fallback switching



### **Push Notifications**

Get notified when an agent completes tasks or sends hook events



### **Live Activity & Widgets**

Real-time agent status on Lock Screen, Dynamic Island, and Home Screen widgets



### **App Lock**

Protect sessions with Face ID or Touch ID






---



## How It Works



```text

┌──────────────────────────────────────────────────────────────────────────┐

│                                                                          │

│   ┌─────────────────┐            WebSocket            ┌─────────────────┐│

│   │   iOS Device    │                                 │   Mac / Linux   ││

│   │                 │  ◄─────────────────────────►    │                 ││

│   │  Tactic Remote  │    ws://local or wss://         │  Server (Node)  ││

│   │      App        │                                 │                 ││

│   └─────────────────┘                                 └────────┬────────┘│

│                                                                │         │

│                                                                ▼         │

│                                                       ┌─────────────────┐│

│                                                       │ Coding Agent    ││

│                                                       │ Claude/Codex/Amp││

│                                                       └─────────────────┘│

│                                                                          │

└──────────────────────────────────────────────────────────────────────────┘

```



**Four ways to run the server:**



| Method | Platform | Command |

|--------|----------|---------|

| **npx** | Mac / Linux / Windows | `npx tacticremote` |

| **Homebrew** | Mac | `brew install TacticSpaceTech/tap/tacticremote` |

| **Mac App** | macOS 14.6+ | Menu bar GUI with one-click start and auto-update |

| **Windows App** (Preview) | Windows 10/11 x64 | Companion app — preview release, may have issues |



---



## Quick Start



The fastest way to get started is one command:



```bash

npx tacticremote

```



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



### Options



```text

npx tacticremote [options]



  -p, --port       Port to listen on          (default: 8765)

  --path         Allowed base directory      (default: $HOME)

  --api-key      Require authentication key

  --tunnel            Enable Cloudflare Tunnel for remote access

  --no-qr             Do not 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](https://github.com/TacticSpaceTech/TacticRemote/releases/tag/v1.8.0)

2. **Install** by opening the DMG and dragging **Tactic Remote** to Applications

3. **Launch** from Applications; a menu bar icon will appear

4. **Start Server** from the menu bar app

5. **Connect** from Tactic Remote on your iPhone or iPad



The Mac app also provides:



- One-click Cloudflare Tunnel for remote access

- Live client count and session monitoring

- Copy server URL, tunnel address, and API key from the menu

- Server compatibility status

- Prevent Sleep while the server is running

- Language switcher for 8 languages

- Auto-start on login

- In-app update checks



### Alternative: Windows Companion App (Preview)



> 🟡 **Preview release.** The Windows companion is published as a preview. Most flows work, but expect rough edges compared to the Mac app and iOS app. We recommend macOS users continue using the Mac companion; we welcome bug reports from Windows users.



1. **Download** the installer from [Releases](https://github.com/TacticSpaceTech/TacticRemote/releases/tag/v1.8.0): `TacticRemote-Windows-Setup-1.8.0.exe`

2. **Install** by running the installer (Windows 10 or 11, x64)

3. **Launch** Tactic Remote from the Start menu

4. **Start Server** from the app window

5. **Connect** from Tactic Remote on your iPhone or iPad



Known limitations of the preview:



- Some terminal scenarios (long ConPTY sessions, complex pairings) may need restart

- Auto-update is not yet enabled — new versions install manually

- Please report issues at [the issue tracker](https://github.com/TacticSpaceTech/TacticRemote/issues)



---



## Download



iOS App


iPhone / iPad





Download on App Store




Mac App


macOS 14.6+





Download DMG




Windows App 🟡


Windows 10/11 — Preview





Download Windows Installer (Preview)




CLI


Mac / Linux / Windows



npx tacticremote



---



## Requirements



| Platform | Minimum Version | Notes |

|----------|----------------|-------|

| **iOS** | 16.4 | iPhone or iPad |

| **macOS** | 14.6 Sonoma | For Mac app or CLI |

| **Windows** | 10 or 11 (x64) | For Windows companion app (Preview) or CLI |

| **Linux** | Any | For CLI (`npx tacticremote`) |

| **Node.js** | 16.0+ | Required for CLI; auto-installed by Mac app when needed |

| **tmux** | Latest | Auto-installed by Mac app or Homebrew |

| **AI coding agent CLI** | Latest | Install and sign in to at least one: Claude Code, OpenAI Codex, or Sourcegraph Amp |



---



## Connection Modes



### Local Network



Default mode for home or office use.



```text

ws://192.168.1.x:8765

```



Ensure your iOS device and Mac are on the same Wi-Fi network.



### Public Access with Cloudflare Tunnel



Connect from anywhere using a secure tunnel, without opening ports on your machine:



```bash

npx tacticremote --tunnel

```



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



---



## Security



### API Key Authentication



```bash

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

```



Then enter the same key in the iOS app.



### Path Restrictions



File operations are restricted to your home directory by default. Customize the allowed base path:



```bash

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

```



### Cloudflare Tunnel



Public access uses Cloudflare's secure tunnel with TLS encryption, so you do not need to open inbound ports.



---



## 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 Wi-Fi stability

- The app supports automatic fallback between LAN and tunnel connections

- iOS app auto-reconnects up to 5 times



### Agent not starting



- Ensure your selected agent CLI is installed and signed in: `claude --version`, `codex --version`, or `amp --version`

- Check tmux is installed: `tmux -V`

- Verify the working directory exists



---



## Documentation



Visit [tacticremote.com](https://tacticremote.com) for:

- Visual setup guides

- Advanced configuration

- Troubleshooting tips

- Release notes



---



## License



This software is proprietary. See [LICENSE](LICENSE) for details.



---



## Support



- [Report Issues](https://github.com/TacticSpaceTech/TacticRemote/issues)

- [Discussions](https://github.com/TacticSpaceTech/TacticRemote/discussions)

- [Website](https://tacticremote.com)



---






Copyright 2025-2026 [TacticSpace Tech](https://tacticspacetech.com/). All rights reserved.