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 web URL and two QR codes for web access and native app pairing.

Details and local-only mode: Hub setup

Start a coding session

hapi

Choose an installed agent from the picker. Its session appears in connected web and native clients. To start one directly, use hapi claude, hapi codex, or another supported agent command. Scripts must specify the agent explicitly.

Open the UI

• Web / PWA: open the web URL shown in the terminal, or scan the web QR code. Enter your access token if prompted.
• Native iOS / Android: open the app and scan the companion QR, or enter the HTTPS hub URL and access token. See Native apps for build and pairing instructions.

Next steps

• Seamless Handoff - Switch between terminal and phone seamlessly
• Hub setup - Access HAPI from anywhere
• Notifications - Native app, Web Push, Telegram and ServerChan notifications
• Deployment - Run HAPI as a persistent background service
• Native apps - Build, pair and use the iOS / Android clients
• Install the PWA - Add the web app to your home screen