Harness Remote

Your coding sessions. Any supported agent. Any device.

A local-first control plane for native AI coding-agent sessions.

Run, observe, resume and continue work across Codex CLI, Claude Code, OpenCode, Oh My Pi and PI from desktop, web or Android — while code, credentials and native Sessions stay on your own machines.

Harness Remote is not another coding agent. It is the remote-control and continuity layer around the coding agents you already use.

Quick start

Desktop

Download Harness Remote from the latest release and open it.

On Windows and macOS, the local computer works immediately: you do not need to start a gateway in a terminal. The desktop app starts and supervises its local Machine runtime automatically.

Add another computer

On the computer you want to control, install Node.js 20+ and make sure at least one supported coding-agent CLI is installed and authenticated.

Then run:

npx harness-remote

Direct-from-GitHub fallback:

npx --yes github:giuliastro/harness-remote

Keep that terminal open. Harness Remote automatically detects the installed coding agents, chooses available ports, generates credentials and starts one Machine gateway.

Common options are optional:

npx harness-remote --root ~/dev
npx harness-remote --port 4900
npx harness-remote --cors https://giuliastro.github.io

Android

Start the gateway on the computer you want to control, then:

1. Open Machines.
2. Tap Scan machine QR code.
3. Scan the QR printed by the gateway.
4. Tap View sessions.

The QR uses a short-lived one-time pairing token. Manual address/credential entry remains available as a fallback.

Web / PWA

Use the hosted web app and allow that browser origin when starting the remote gateway:

npx harness-remote --cors https://giuliastro.github.io

For local web development:

cd web
npm ci
npm run dev

Then start the gateway with:

npx harness-remote --cors http://localhost:5173

See the Quick start guide for advanced options and troubleshooting.

What it gives you

• Native Sessions — existing Sessions remain owned by Codex, Claude, OpenCode, OMP or PI.
• Remote control — follow activity, send prompts, Stop turns and handle supported questions/permissions.
• One workspace — Machines → Projects → native Sessions.
• Cross-agent continuation — continue a task with another coding agent without pretending their hidden contexts are the same.
• Cross-machine continuation — continue work on another configured machine while preserving Project identity and lineage.
• Model discovery — models, defaults and variants come from the running harness instead of hardcoded assumptions.
• Attention visibility — questions, permissions and other blocking states stay visible even when the Session is not open.
• Recovery — reconnect, idle/wake and desktop-runtime recovery are built around the native Session as the source of truth.
• Local-first operation — repositories, credentials, subscriptions and native Session persistence stay on your machines.

Native Sessions stay authoritative

Harness Remote does not create a synthetic universal conversation model.

The coding agent still owns: