Getting Started

Prerequisites

Step 1: Install the CLI

Install the ForkOff CLI globally using npm, yarn, or pnpm:

npm install -g forkoff

yarn global add forkoff

pnpm add -g forkoff

On macOS, you can also use Homebrew:

brew install forkoff

Verify the installation:

forkoff --version

Step 2: Install the Mobile App

Download ForkOff from your device's app store:

Step 3: Pair Your Devices

Generate a pairing QR code on your computer:

forkoff pair

A QR code will appear in your terminal. Open the ForkOff mobile app, tap “Add Device”, and scan the QR code. You'll be connected instantly.

Step 4: Enable Claude Integration

Install the Claude Code hooks to route approvals through ForkOff:

forkoff tools --install-hooks

This automatically detects Claude Code and configures it to send approval requests to your phone. You'll see a confirmation message when it's done.

Step 5: Verify It Works

Check that everything is connected:

forkoff status

You should see your paired device and connected AI tools. Now open Claude Code and start a task that requires approval - you'll get a notification on your phone!