HAPI means "哈皮," a Chinese transliteration of Happy. Great credit to the original project.

Run Claude Code / Codex / Gemini sessions locally and control them remotely through a Web / PWA / Telegram Mini App.

Why HAPI? HAPI is a local-first alternative to Happy. See Why Not Happy? for the key differences.

• Start AI coding sessions from any machine.
• Monitor and control sessions from your phone or browser.
• Approve or deny tool permissions remotely.
• Browse files and view git diffs.
• Track session progress with todo lists.
• Supports multiple AI backends: Claude Code, Codex, and Gemini.

npm install -g @twsxtd/hapi

Or with Homebrew:

brew install tiann/tap/hapi

Other options: Installation guide

1. Start the server:

hapi server

2. Start a coding session:

hapi

3. Open the UI at http://localhost:3006 and log in with the token in ~/.hapi/settings.json.

docker run -d --name hapi -p 3006:3006 -v hapi-data:/data ghcr.io/tiann/hapi-server:latest

More setup options: Installation guide

• Quick Start
• Installation
• PWA
• How it Works
• Why HAPI
• FAQ

• Claude CLI installed and logged in (claude on PATH) for Claude Code sessions.
• Bun if building from source.

bun install
bun run build:single-exe