npm install -g @twsxtd/hapi --registry=https://registry.npmjs.orgOther install options (Homebrew, npx, prebuilt binary, source): Installation
hapi hub --relayOn 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
hapiChoose 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.
- Web / PWA (free): open the web URL shown in the terminal, or scan the web QR code. Enter your access token if prompted.
- Native iOS / Android (paid): install HAPI from the App Store or Google Play, then scan the companion QR or enter the HTTPS hub URL and access token. See Native apps for pairing.
- 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