{"id":47858234,"url":"https://github.com/tacticspacetech/tacticremote","last_synced_at":"2026-05-15T13:01:50.920Z","repository":{"id":334955363,"uuid":"1143764707","full_name":"TacticSpaceTech/TacticRemote","owner":"TacticSpaceTech","description":"Control Claude Code from your iPhone or iPad — Tactic Remote","archived":false,"fork":false,"pushed_at":"2026-04-24T20:20:24.000Z","size":1117,"stargazers_count":11,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2026-04-24T22:38:01.448Z","etag":null,"topics":["claude-code","ios","macos","remote-control","ssh","terminal","tmux","websocket"],"latest_commit_sha":null,"homepage":"https://www.tacticremote.com","language":null,"has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"other","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/TacticSpaceTech.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":"CONTRIBUTING.md","funding":null,"license":"LICENSE","code_of_conduct":"CODE_OF_CONDUCT.md","threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":"SECURITY.md","support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2026-01-28T00:37:08.000Z","updated_at":"2026-04-24T20:18:58.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/TacticSpaceTech/TacticRemote","commit_stats":null,"previous_names":["mjykim99/claude-remote","tacticspacetech/tacticremote"],"tags_count":13,"template":false,"template_full_name":null,"purl":"pkg:github/TacticSpaceTech/TacticRemote","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/TacticSpaceTech%2FTacticRemote","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/TacticSpaceTech%2FTacticRemote/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/TacticSpaceTech%2FTacticRemote/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/TacticSpaceTech%2FTacticRemote/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/TacticSpaceTech","download_url":"https://codeload.github.com/TacticSpaceTech/TacticRemote/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/TacticSpaceTech%2FTacticRemote/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":33067476,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-05-15T11:35:32.926Z","status":"ssl_error","status_checked_at":"2026-05-15T11:35:31.362Z","response_time":103,"last_error":"SSL_connect returned=1 errno=0 peeraddr=140.82.121.5:443 state=error: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["claude-code","ios","macos","remote-control","ssh","terminal","tmux","websocket"],"created_at":"2026-04-03T23:05:08.540Z","updated_at":"2026-05-15T13:01:50.907Z","avatar_url":"https://github.com/TacticSpaceTech.png","language":null,"funding_links":[],"categories":[],"sub_categories":[],"readme":"\u003cdiv align=\"center\"\u003e\n\n\u003cimg src=\"assets/icon.png\" width=\"192\" alt=\"Tactic Remote\"\u003e\n\n# Tactic Remote\n\n### Control Claude Code, Codex, and Amp from your iPhone or iPad\n\n[![iOS](https://img.shields.io/badge/iOS-16.4%2B-blue.svg?style=flat\u0026logo=apple\u0026logoColor=white)](https://apps.apple.com/us/app/tactic-remote-ai-coding/id6758008464)\n[![macOS](https://img.shields.io/badge/macOS-14.6%2B-green.svg?style=flat\u0026logo=apple\u0026logoColor=white)](https://github.com/TacticSpaceTech/TacticRemote/releases)\n[![npm](https://img.shields.io/badge/npx-tacticremote-cb3837.svg?style=flat\u0026logo=npm\u0026logoColor=white)](https://www.npmjs.com/package/tacticremote)\n[![App Store](https://img.shields.io/badge/App%20Store-Available-purple.svg?style=flat\u0026logo=apple\u0026logoColor=white)](https://apps.apple.com/us/app/tactic-remote-ai-coding/id6758008464)\n\n[Website](https://tacticremote.com) • [Documentation](https://tacticremote.com/docs) • [Support](https://github.com/TacticSpaceTech/TacticRemote/issues)\n\n\u003c/div\u003e\n\n---\n\n\u003e **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.\n\n---\n\n## Overview\n\nTactic 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.\n\nIt is built for developers who want to stay close to AI coding sessions without staying at their desk.\n\n---\n\n## What's New in 1.8.0\n\n- **Chat Mode refinements** — Messages, tool activity, Thinking blocks, and streaming output are easier to read on mobile.\n- **Quick Prompts Library** — Save reusable review, debugging, testing, and handoff prompts for one-tap reuse.\n- **Mobile Git review** — Inspect changed files and per-file diffs from the phone before deciding what the agent should do next.\n- **Server compatibility checks** — See server version, protocol version, platform, and supported capabilities more clearly.\n- **Mac companion reliability** — Prevent Sleep support helps keep long-running AI coding sessions available, and in-app update checks remain supported.\n\n---\n\n## Features\n\n\u003cdiv align=\"center\"\u003e\n\n### **Chat Mode for Agent Output**\nRead agent messages, tool calls, Thinking sections, and streaming updates in a mobile-friendly layout\n\n### **Quick Prompts Library**\nSave common review, test, debug, and summary prompts so repeat workflows are always close\n\n### **Mobile Git Review**\nView changed files, inspect diffs, and decide whether an agent's work should continue\n\n### **Multi-Agent Sessions**\nChoose Claude Code, OpenAI Codex, or Sourcegraph Amp when creating a session\n\n### **Git Worktree Workflow**\nGroup sibling worktrees and switch between parallel implementation branches\n\n### **Smart Prompt Toolbar**\nAuto-reveals shortcuts for blocking TUI prompts like confirmations and trust dialogs\n\n### **Terminal Mode**\nFull terminal with ANSI color support, real-time streaming, search, and keyboard submit\n\n### **iPad-Optimized Layout**\nNative split-view with hardware keyboard shortcuts\n\n### **Cloud Speech-to-Text**\nDictate prompts in 25+ languages\n\n### **File Uploads**\nSend files from iOS to the remote server\n\n### **Multi-Session Management**\nCreate, switch, and delete multiple tmux sessions\n\n### **Remote File Browser**\nBrowse your Mac's file system and select project directories from iOS\n\n### **Local \u0026 Remote Access**\nConnect via Wi-Fi or Cloudflare Tunnel, with automatic fallback switching\n\n### **Push Notifications**\nGet notified when an agent completes tasks or sends hook events\n\n### **Live Activity \u0026 Widgets**\nReal-time agent status on Lock Screen, Dynamic Island, and Home Screen widgets\n\n### **App Lock**\nProtect sessions with Face ID or Touch ID\n\n\u003c/div\u003e\n\n---\n\n## How It Works\n\n```text\n┌──────────────────────────────────────────────────────────────────────────┐\n│                                                                          │\n│   ┌─────────────────┐            WebSocket            ┌─────────────────┐│\n│   │   iOS Device    │                                 │   Mac / Linux   ││\n│   │                 │  ◄─────────────────────────►    │                 ││\n│   │  Tactic Remote  │    ws://local or wss://         │  Server (Node)  ││\n│   │      App        │                                 │                 ││\n│   └─────────────────┘                                 └────────┬────────┘│\n│                                                                │         │\n│                                                                ▼         │\n│                                                       ┌─────────────────┐│\n│                                                       │ Coding Agent    ││\n│                                                       │ Claude/Codex/Amp││\n│                                                       └─────────────────┘│\n│                                                                          │\n└──────────────────────────────────────────────────────────────────────────┘\n```\n\n**Four ways to run the server:**\n\n| Method | Platform | Command |\n|--------|----------|---------|\n| **npx** | Mac / Linux / Windows | `npx tacticremote` |\n| **Homebrew** | Mac | `brew install TacticSpaceTech/tap/tacticremote` |\n| **Mac App** | macOS 14.6+ | Menu bar GUI with one-click start and auto-update |\n| **Windows App** (Preview) | Windows 10/11 x64 | Companion app — preview release, may have issues |\n\n---\n\n## Quick Start\n\nThe fastest way to get started is one command:\n\n```bash\nnpx tacticremote\n```\n\nScan the QR code with the Tactic Remote iOS app and you are connected.\n\n### Options\n\n```text\nnpx tacticremote [options]\n\n  -p, --port \u003cn\u003e      Port to listen on          (default: 8765)\n  --path \u003cdir\u003e        Allowed base directory      (default: $HOME)\n  --api-key \u003ckey\u003e     Require authentication key\n  --tunnel            Enable Cloudflare Tunnel for remote access\n  --no-qr             Do not show QR code\n  -h, --help          Show this help\n```\n\n### Alternative: Mac Menu Bar App\n\nIf you prefer a graphical interface:\n\n1. **Download** the DMG from [Releases](https://github.com/TacticSpaceTech/TacticRemote/releases/tag/v1.8.0)\n2. **Install** by opening the DMG and dragging **Tactic Remote** to Applications\n3. **Launch** from Applications; a menu bar icon will appear\n4. **Start Server** from the menu bar app\n5. **Connect** from Tactic Remote on your iPhone or iPad\n\nThe Mac app also provides:\n\n- One-click Cloudflare Tunnel for remote access\n- Live client count and session monitoring\n- Copy server URL, tunnel address, and API key from the menu\n- Server compatibility status\n- Prevent Sleep while the server is running\n- Language switcher for 8 languages\n- Auto-start on login\n- In-app update checks\n\n### Alternative: Windows Companion App (Preview)\n\n\u003e 🟡 **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.\n\n1. **Download** the installer from [Releases](https://github.com/TacticSpaceTech/TacticRemote/releases/tag/v1.8.0): `TacticRemote-Windows-Setup-1.8.0.exe`\n2. **Install** by running the installer (Windows 10 or 11, x64)\n3. **Launch** Tactic Remote from the Start menu\n4. **Start Server** from the app window\n5. **Connect** from Tactic Remote on your iPhone or iPad\n\nKnown limitations of the preview:\n\n- Some terminal scenarios (long ConPTY sessions, complex pairings) may need restart\n- Auto-update is not yet enabled — new versions install manually\n- Please report issues at [the issue tracker](https://github.com/TacticSpaceTech/TacticRemote/issues)\n\n---\n\n## Download\n\n\u003ctable align=\"center\"\u003e\n\u003ctr\u003e\n\u003ctd align=\"center\" width=\"25%\"\u003e\n\u003cb\u003eiOS App\u003c/b\u003e\u003cbr\u003e\n\u003ci\u003eiPhone / iPad\u003c/i\u003e\u003cbr\u003e\u003cbr\u003e\n\u003ca href=\"https://apps.apple.com/us/app/tactic-remote-ai-coding/id6758008464\"\u003e\n\u003cimg src=\"https://developer.apple.com/assets/elements/badges/download-on-the-app-store.svg\" width=\"160\" alt=\"Download on App Store\"\u003e\n\u003c/a\u003e\n\u003c/td\u003e\n\u003ctd align=\"center\" width=\"25%\"\u003e\n\u003cb\u003eMac App\u003c/b\u003e\u003cbr\u003e\n\u003ci\u003emacOS 14.6+\u003c/i\u003e\u003cbr\u003e\u003cbr\u003e\n\u003ca href=\"https://github.com/TacticSpaceTech/TacticRemote/releases/tag/v1.8.0\"\u003e\n\u003cimg src=\"https://img.shields.io/badge/Download-DMG-success.svg?style=for-the-badge\u0026logo=apple\" width=\"160\" alt=\"Download DMG\"\u003e\n\u003c/a\u003e\n\u003c/td\u003e\n\u003ctd align=\"center\" width=\"25%\"\u003e\n\u003cb\u003eWindows App\u003c/b\u003e 🟡\u003cbr\u003e\n\u003ci\u003eWindows 10/11 — Preview\u003c/i\u003e\u003cbr\u003e\u003cbr\u003e\n\u003ca href=\"https://github.com/TacticSpaceTech/TacticRemote/releases/tag/v1.8.0\"\u003e\n\u003cimg src=\"https://img.shields.io/badge/Download-EXE%20(Preview)-orange.svg?style=for-the-badge\u0026logo=windows\" width=\"160\" alt=\"Download Windows Installer (Preview)\"\u003e\n\u003c/a\u003e\n\u003c/td\u003e\n\u003ctd align=\"center\" width=\"25%\"\u003e\n\u003cb\u003eCLI\u003c/b\u003e\u003cbr\u003e\n\u003ci\u003eMac / Linux / Windows\u003c/i\u003e\u003cbr\u003e\u003cbr\u003e\n\u003ccode\u003enpx tacticremote\u003c/code\u003e\n\u003c/td\u003e\n\u003c/tr\u003e\n\u003c/table\u003e\n\n---\n\n## Requirements\n\n| Platform | Minimum Version | Notes |\n|----------|----------------|-------|\n| **iOS** | 16.4 | iPhone or iPad |\n| **macOS** | 14.6 Sonoma | For Mac app or CLI |\n| **Windows** | 10 or 11 (x64) | For Windows companion app (Preview) or CLI |\n| **Linux** | Any | For CLI (`npx tacticremote`) |\n| **Node.js** | 16.0+ | Required for CLI; auto-installed by Mac app when needed |\n| **tmux** | Latest | Auto-installed by Mac app or Homebrew |\n| **AI coding agent CLI** | Latest | Install and sign in to at least one: Claude Code, OpenAI Codex, or Sourcegraph Amp |\n\n---\n\n## Connection Modes\n\n### Local Network\n\nDefault mode for home or office use.\n\n```text\nws://192.168.1.x:8765\n```\n\nEnsure your iOS device and Mac are on the same Wi-Fi network.\n\n### Public Access with Cloudflare Tunnel\n\nConnect from anywhere using a secure tunnel, without opening ports on your machine:\n\n```bash\nnpx tacticremote --tunnel\n```\n\nThe server generates a `wss://` URL automatically. Use this URL in the iOS app.\n\n---\n\n## Security\n\n### API Key Authentication\n\n```bash\nnpx tacticremote --api-key \"your-secure-key\"\n```\n\nThen enter the same key in the iOS app.\n\n### Path Restrictions\n\nFile operations are restricted to your home directory by default. Customize the allowed base path:\n\n```bash\nnpx tacticremote --path \"/Users/yourname/Projects\"\n```\n\n### Cloudflare Tunnel\n\nPublic access uses Cloudflare's secure tunnel with TLS encryption, so you do not need to open inbound ports.\n\n---\n\n## Troubleshooting\n\n### Cannot connect to server\n\n- Verify Mac and iOS are on the same network\n- Check Mac firewall allows connections on port 8765\n- Confirm server is running: `lsof -i :8765`\n\n### Connection drops frequently\n\n- Check Wi-Fi stability\n- The app supports automatic fallback between LAN and tunnel connections\n- iOS app auto-reconnects up to 5 times\n\n### Agent not starting\n\n- Ensure your selected agent CLI is installed and signed in: `claude --version`, `codex --version`, or `amp --version`\n- Check tmux is installed: `tmux -V`\n- Verify the working directory exists\n\n---\n\n## Documentation\n\nVisit [tacticremote.com](https://tacticremote.com) for:\n- Visual setup guides\n- Advanced configuration\n- Troubleshooting tips\n- Release notes\n\n---\n\n## License\n\nThis software is proprietary. See [LICENSE](LICENSE) for details.\n\n---\n\n## Support\n\n- [Report Issues](https://github.com/TacticSpaceTech/TacticRemote/issues)\n- [Discussions](https://github.com/TacticSpaceTech/TacticRemote/discussions)\n- [Website](https://tacticremote.com)\n\n---\n\n\u003cdiv align=\"center\"\u003e\n\nCopyright 2025-2026 [TacticSpace Tech](https://tacticspacetech.com/). All rights reserved.\n\n\u003c/div\u003e\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ftacticspacetech%2Ftacticremote","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Ftacticspacetech%2Ftacticremote","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ftacticspacetech%2Ftacticremote/lists"}