Jas
ARR by Jas

Agent Remote Relay

Info
Desktop & Mobile PWA · Standalone App

Why ARR

01

No SSH or terminal multiplexers

Stop opening manual SSH connections or juggling tmux sessions. Open ARR to dispatch tasks and commands directly to agents running on your server.

02

Zero video streaming or VNC lag

Avoid heavy remote desktop streams, high CPU encoders, and laggy VNC screens. ARR communicates over low-overhead JSON-RPC WebSockets.

03

Unified diff & workspace inspection

Inspect line-by-line file changes, test outputs, and system logs with syntax highlighting before allowing agents to commit or overwrite files.

04

One-click tool & shell approvals

When agents request dangerous bash execution, build commands, or package installations on your host machine, review and approve with one click.

Architecture

Local Daemon

Host process listening on port 2436.

The curl installer provisions a self-contained runner in ~/.agent-remote-relay. It binds a local WebSocket/HTTP server on port 2436, exposes MCP tool bridges to connected agents, and communicates directly over your local subnet with zero cloud dependencies.

Host Execution

Runs natively as a supervised user daemon on Linux, macOS, and WSL with standard POSIX permissions.

MCP Protocol

Provides standard SSE and stdio bridges for Antigravity, Claude Code, Cursor, and OpenCode.

Subnet Isolation

Direct local communication guarded by a random 0600 token. No external relays or telemetry.

FAQ

What is Agent Remote Relay?

ARR is a local-first bridge and client interface for autonomous AI coding agents. It connects to host processes via WebSocket and Model Context Protocol (MCP) to stream status, review diffs, and approve tool execution.

Why do I need both the curl daemon and the client app?

The daemon runs as a background process on the host machine to execute agent commands and expose the local MCP/WebSocket server. The client (Desktop or Mobile PWA) is the interface used to review diffs and send approvals over the local network.

How do I run the relay daemon on a host?

Run the curl installer in your terminal on Linux, macOS, or WSL. The daemon initializes in ~/.agent-remote-relay and listens on port 2436.

Do code, tokens, or prompt outputs leave the local network?

No. ARR communicates exclusively over local sockets and LAN IP endpoints. No external relays, analytics, or third-party servers are involved.

Which agents are supported?

Any agent supporting standard MCP or the ARR JSON-RPC protocol, including Antigravity, Claude Code, Cursor, OpenCode, and Ollama.

Built by

Built by Jas

A simple, portable companion for monitoring and steering autonomous coding agents from your phone or tablet on your local network.