Follow and drive your coding agents from your phone.
Claude Code, Codex, Gemini CLI, Kimi CLI or Qwen Code runs in tmux on your own machine. Remote Harness streams the conversation to your phone from anywhere, encrypted end to end, so you can read what the agent did, answer its permission requests, send the next prompt and start new sessions.
Your phone, your machine. Nothing in between can read it.
Sessions run inside tmux. The agent reports what happens through its native hooks, a small daemon on the machine bridges both to the phone, and end-to-end encryption keeps it all private.
Your phone
Native iOS and Android app. Reads the conversation, answers permissions, sends prompts, keys, photos and voice. Push and live status, with no content inside.
Your machine
The remote-harness daemon: tails transcripts, drives tmux, receives the agent’s hooks on 127.0.0.1. One line to install, a Login Item or systemd unit to keep running.
Your agents, in tmux
One window per session, one alias per profile, for Claude Code, Codex, Gemini CLI, Kimi CLI or Qwen Code.
see more
- Install on the machine
One command. It checks tmux, git, ripgrep and Node, finds your profiles, and installs the launchers.
- Scan the QR code
The setup shows it at the end (or
remote-harness pair). At home or away, the phone finds the machine, done. - Run your alias
workopens Claude Code in tmux with that profile. The session shows up on the phone, fully controllable.
Everything the terminal shows, and the parts the terminal can’t.
One list, every profile
Sessions from all your profiles, sorted by what moved last, with a “waiting for you” strip on top.
Live conversation
Markdown, thinking, tool calls, diffs and results, streamed as they happen and paginated back to the start.
Permissions from your pocket
Allow, deny or always allow. “Always” is written as a rule by the agent itself and undoable from the CLI.
Queue or send now
Line up follow-ups while the agent works; they go in order when the turn ends. Hold to send immediately.
Raw terminal
The tmux pane itself, for menus and anything the structured view doesn’t cover, with a key bar for Esc, Ctrl+C, arrows and Tab.
Start, resume, close
New sessions in any folder, optionally in their own git worktree. Resume read-only ones. Close with worktree clean-up that never discards work silently.
Live status
Lock screen and Dynamic Island on iOS, a silent notification on Android: state, step type and elapsed time, never the text.
Subagents, voice, photos
Follow subagents and background tasks, dictate prompts on-device, attach photos. Autocomplete for @files and /commands.
The daemon is a remote shell, so it’s locked down by default.
One line on the machine, one scan on the phone.
curl -fsSL https://remoteharness.app/install | bashChecks the system, installs what’s missing (Homebrew, apt, dnf, pacman or zypper), builds the daemon and opens the guided setup.
irm https://remoteharness.app/install | iexIn PowerShell. Sets up WSL2 with Ubuntu when it is missing (reboot if asked, then run it again) and then runs the Linux installer inside it.
- Node 24+ (bundled if missing)
- tmux
- git
- ripgrep
- claude, codex, gemini, kimi or qwen on PATH
Get the app
iPhone & iPadTestFlight (beta) · iOS 17+ AndroidGoogle Play (testing) · Android 10+Nothing else to install on the phone. Installed the app first? Its pairing screen walks you through the machine setup.
Questions people ask first
The full guide is in the documentation: getting started, using the app, the daemon CLI, security, troubleshooting.
Does it work away from home?
Yes: directly at home, through the end-to-end encrypted connection relay elsewhere, with no port forwarding and no VPN. The machine must be awake; the Troubleshooting page of the docs covers sleep and lock settings.
Which agents are supported?
Claude Code, Codex CLI, Gemini CLI, Kimi CLI and Qwen Code, with every profile (CLAUDE_CONFIG_DIR, CODEX_HOME, ~/.gemini, KIMI_SHARE_DIR, QWEN_HOME) in one list, including Claude Code profiles routed through OpenRouter.
Can it run my agent unsupervised?
Only as far as the agent’s own permission modes allow. The app offers default, accept edits, plan and auto; it never offers bypass. Every permission still goes through you, from the phone or the machine.
What about sessions started outside tmux?
They still show up, read-only. Resume one from the phone and it reopens inside tmux, fully controllable.
Is there a cloud component?
Only relays that can’t read anything. Away from home the connection relay forwards end-to-end encrypted traffic (or run your own), and optional push goes through FCM (your Firebase project or the content-free push relay). Nothing stores your sessions.
Does the daemon need a Mac?
No: macOS, Linux (systemd) and Windows through WSL2 are all supported. The app runs on iOS and Android.