Documentation
Remote Harness lets you follow and drive Claude Code, Codex, Gemini CLI, Kimi CLI and Qwen Code sessions that run in tmux on your own computer, from your phone, from anywhere and encrypted end to end. These pages cover the user side; the code, the architecture and the specifications live in the repository.
Pages
- Getting started: requirements, the one-line install on macOS, Linux and Windows (WSL2), the app, pairing.
- Using the app: session list, conversation, prompts, permissions, terminal, sessions and worktrees, live status, notifications, profiles and OpenRouter, settings.
- The daemon: CLI commands, the configuration file, the background service, updates and channels, the tray icon, logs.
- Cloud server: run the daemon on a cloud VM (AWS, DigitalOcean, GCP, Oracle): ports and firewalls, the service without a login, the terminal over SSH, unstable connections.
- Security & privacy: what the daemon can do, what leaves your machine, keys and pairing, reporting a problem.
- Troubleshooting: connection, the relay, push, sleep, read-only sessions, WSL, version mismatch.
- Contributing: how the project is built and how to help.
Quick start
- On the computer:
curl -fsSL https://remoteharness.app/install | bash(Windows:irm https://remoteharness.app/install | iexin PowerShell). - Install the app on the phone, then scan the QR code the setup shows at the end.
- Run your alias (for example
work) instead ofclaude. The session appears on the phone, fully controllable.