Remote Harness GitHub ↗
End-to-end encrypted · tmux · open source

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.

macOS · Linux · Windows (WSL2)iOS · AndroidMIT, no account, no VPN
Works with Claude Code Codex CLI Gemini CLI Kimi Qwen Code OpenRouter models via profiles
How it works

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.

personal → ~/.claude
see more
work → ~/.claude-workcodex → ~/.codexgem → ~/.geminikm → ~/.kimiqw → ~/.qwenopenrouter → ~/.claude-openrouter
  1. Install on the machine

    One command. It checks tmux, git, ripgrep and Node, finds your profiles, and installs the launchers.

  2. 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.

  3. Run your alias

    work opens Claude Code in tmux with that profile. The session shows up on the phone, fully controllable.

Features

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.

Privacy & security

The daemon is a remote shell, so it’s locked down by default.

The relay can’t read itAt home the app talks to the daemon directly; elsewhere through a connection relay. Both paths are encrypted end to end with Noise and per-device keys, so the relay only forwards bytes it can’t read, and keeps no logs.
Keys per deviceEach phone pairs with a single-use code that expires in 5 minutes and gets its own keys, kept in the Keychain (macOS), Secret Service (Linux) or the phone's secure storage. Revoke one any time.
Content-free pushNotifications carry a title, a profile and a session id. The live status adds the session name and folder, nothing from the conversation.
No bypassThe app never offers the agent’s “bypass permissions” mode. Edits to your dotfiles are merged, backed up and fully reversible.
Opt-in onlyNothing is sent anywhere unless you choose it: push through your own Firebase project or the content-free relay, error reports and performance data, all without session content.
Open sourceMIT licensed, built in the open with OpenSpec. Read SECURITY.md to report a problem.
Install

One line on the machine, one scan on the phone.

curl -fsSL https://remoteharness.app/install | bash

Checks the system, installs what’s missing (Homebrew, apt, dnf, pacman or zypper), builds the daemon and opens the guided setup.

  • 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.

Docs & FAQ

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.