Quick Start

Install HAPI

npm install -g @twsxtd/hapi --registry=https://registry.npmjs.org

Other install options (Homebrew, npx, prebuilt binary, source): Installation

Start the hub

hapi hub --relay

On first run, HAPI prints an access token and saves it to ~/.hapi/settings.json. The terminal displays a URL and QR code for remote access.

Details and local-only mode: Hub setup

Start a coding session

hapi

This starts Claude Code wrapped with HAPI. The session appears in the web UI.

Open the UI

Open the URL shown in the terminal, or scan the QR code with your phone.

Enter your access token to log in.

Next steps

• Seamless Handoff - Switch between terminal and phone seamlessly
• Hub setup - Access HAPI from anywhere
• Notifications - Set up Telegram or ServerChan notifications
• Deployment - Run HAPI as a persistent background service
• Install the App - Add HAPI to your home screen