Claude Remote Runner

Remote Runner for Claude

**Disclaimer:** This is an unofficial community project and is not affiliated with, endorsed by, or associated with Anthropic. "Claude" is a trademark of Anthropic.

[](https://www.npmjs.com/package/@sohampawar1866/remote-claude) [](https://opensource.org/licenses/MIT)

A cross-platform CLI wrapper and Progressive Web App (PWA) that lets you control [Claude Code](https://docs.anthropic.com/en/docs/agents-and-tools/claude-code/overview) remotely. Watch Claude code in real-time on your phone via WebRTC, get push notifications when it pauses for input, and respond directly from your mobile device.

Installation

Install globally via npm:

npm install -g @sohampawar1866/remote-claude

**Note on Self-Hosting:** By default, this connects to a pre-deployed frontend and signaling server (zero-config). If you prefer absolute data sovereignty, you can easily self-host both the PWA and the Appwrite signaling server. See the [Self-Hosting](#self-hosting-optional) section at the bottom of this README.

Usage

To start a remote session, simply run:

remote-claude

On first launch, the CLI prints a QR code. Scan it with your phone's native camera to instantly open the PWA and establish a live WebRTC peer connection.

Options

Flag	Description
-k, --keep-awake	Prevent the system from sleeping while Claude runs
-d, --debug	Enable debug logging for pause detection state transitions
--silence-threshold	Silence threshold in ms before fallback pause detection (default: 3000)
--pattern-debounce	Pattern match debounce in ms (default: 1500)
--no-hooks	Disable automatic Claude Code hook installation
`-c, --command <c