Skip to main content

Quick Start

Get Remi monitoring Claude Code in 5 minutes.

Prerequisites​

Step 1: Install Remi​

Homebrew (macOS/Linux):

brew install yooz-labs/tap/remi

npm:

npm install -g @yooz-labs/remi

From source (requires Bun):

git clone https://github.com/yooz-labs/remi.git
cd remi
bun install && bun run build && bun link

Verify it works:

remi --version

Step 2: Generate Your Identity​

Remi uses Ed25519 keys for authentication. Generate your server identity:

remi keygen

By default, this creates an unencrypted identity for zero-friction startup. To encrypt with a passphrase, use remi keygen --passphrase.

Step 3: Start Remi​

Run Remi from any project directory. All arguments after remi are passed through to Claude Code:

remi my-project

Claude Code starts normally in your terminal. Remi runs silently in the background, logging to ~/.remi/remi.log.

To see your connection code for remote access:

remi code

Step 4: Connect From Your Browser​

Same Network (Direct)​

If your browser is on the same machine, open the Remi web app and enter:

ws://localhost:18765/ws

To connect from another device on the same network, use your machine's IP (Remi binds to all interfaces by default):

ws://192.168.1.100:18765/ws

Different Network (Relay Code)​

Run remi code to see your connection code, then enter it in the Remi web app (e.g., AXBY-1234). The signaling server bridges the connection automatically.

Step 5: Respond to Questions​

When Claude asks a question (like a tool permission prompt), you will see it on your phone or browser. Tap Yes or No, or type a custom response.

What's Next?​