Quick Start

Install HAPI

npm

npm install -g @twsxtd/hapi

Homebrew

brew install tiann/tap/hapi

npx (one-off)

npx @twsxtd/hapi

Other install options: Installation

Start the hub

hapi hub --relay

On first run, HAPI prints an access token and saves it to ~/.hapi/settings.json.

hapi server remains supported as an alias.

The terminal will display a URL and QR code for remote access.

End-to-end encrypted with WireGuard + TLS.

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 notifications
• Install the App - Add HAPI to your home screen