Farwatch
End-to-end encrypted

Control AI agents
from anywhere

Access Claude Code, Aider, Copilot, and Gemini from your phone via secure terminal mirroring. The relay only forwards encrypted blobs — it never sees plaintext.

$brew install yipjunkai/farwatch/farwatch
Works with any CLI tool
iOS + Android + Web
Zero-knowledge relay
farwatch
$farwatch start claude
Farwatch v0.1.0 Starting Claude Code session... Session ID: 550e8400-e29b-41d4-a716 Encryption: X25519 + AES-256-GCM Scan QR code to connect: ┌─────────────────────────┐ │ ▄▄▄▄▄ █▀▀▄▄ █ ▄▄▄▄▄ │ │ █ █ █▄▀▄█▀█ █ █ │ │ █▄▄▄█ █ ▀▄ ▀▄ █▄▄▄█ │ │ ▄▄▄▄▄ ▄▀▀▀▄▀▄ ▄ ▄ ▄ │ │ █▀▀▀▄ ▄▀█▄▄▀▀ ▀▄▄█▄ │ │ ▄▀▄▄█ ▀▄▀▄▀▀█▀ █▀▄▀ │ │ ▄▄▄▄▄ █▄▀█ ▀▀█▀▄▄█▄ │ │ █ █ █ ▀▄▄█▀ ▄ ▀▄ │ │ █▄▄▄█ ▄▀▄▄▀▀█▀▀█▄█▀ │ └─────────────────────────┘ Or enter code: HX4KMR-92VTN7-P3WQBL Waiting for connection...
Device connected from iPhone

How it works

One brew install, one command, one QR scan. No account required when self-hosting.

01

Start your AI agent

Run farwatch start claude on your dev machine. Works with Claude Code, Aider, Copilot, Gemini, or any CLI tool.

$farwatch start claude
02

Scan the QR code

The CLI generates an ephemeral X25519 keypair and displays a QR code. Scan it or type the pairing code.

HX4KMR-92VTN7-P3WQBL
03

Control from anywhere

Send prompts, approve tool calls, dictate with voice. See structured agent output or raw terminal — your choice.

Full mobile control
E2E encrypted by default

What Farwatch
actually does

Encrypted terminal mirroring with a structured agent UI on top. Open-source relay, native mobile apps.

E2E Encrypted

X25519 key exchange with AES-256-GCM encryption. Your terminal data is encrypted before it ever leaves your machine.

Works with any CLI AI

Claude Code, Aider, GitHub Copilot CLI, Gemini CLI, or any terminal-based AI tool. If it runs in a terminal, Farwatch mirrors it.

Speech-to-code

Pro

Dictate prompts using on-device speech-to-text. Useful when you're away from your desk or just don't want to type on a phone.

Structured agent UI

Pro

Native cards for thinking blocks, tool calls, permission requests, and cost tracking. Not just raw terminal bytes.

Cross-platform

iOS, Android, and web. Three clients, same encrypted protocol, same features.

Self-hostable relay

The relay server is MIT-licensed. Run it on your own box if you don't want to use ours.

Zero-knowledge architecture

The relay server never sees your unencrypted data. It only passes encrypted frames between your devices.

Low latency

WebSocket relay with sub-100ms round trips. Terminal output streams frame-by-frame over MessagePack.

Open-source CLI + relay

Control your AI agents
from anywhere

Install the CLI, start a session, scan the QR code.

$brew install yipjunkai/farwatch/farwatch