mirror of
https://github.com/wu736139669/hapi.git
synced 2026-08-05 06:24:37 +00:00
weishu
94823b7a8b
- Added /health endpoint to server for readiness checks (no auth required) - Created autoStartServer module that auto-starts server when: - HAPI_SERVER_URL not set (using default localhost:3006) - cliApiToken exists in settings (server previously used) - Port 3006 is not currently listening - Server runs as child process (not daemon) and exits when CLI exits - Integrated maybeAutoStartServer() into hapi, codex, and gemini commands
HAPI
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.
Features
- Seamless Handoff - Work locally with native Claude Code or Codex, switch to remote when needed, switch back anytime.
- 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.
Getting Started
npm install -g @twsxtd/hapi
hapi server
Open http://localhost:3006 and log in with the token.
More options: Quick Start | Installation
Docs
Requirements
- Claude CLI installed and logged in (
claudeon PATH) for Claude Code sessions. - Bun if building from source.
Build from source
bun install
bun run build:single-exe