mirror of
https://github.com/wu736139669/hapi.git
synced 2026-08-05 06:24:37 +00:00
weishu
1e46bd3295
- Replace VitePress router with window.location for docs index redirect - Add redirect rules for /docs and /docs/ paths to quick-start guide - Simplify navigation by removing section anchor links - Update all CTA buttons to link directly to /docs/ instead of home sections - Consolidate navigation layout on both desktop and mobile views
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
- 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.
Installation
npm install -g @twsxtd/hapi
Or with Homebrew:
brew install tiann/tap/hapi
Other options: Installation guide
Quickstart
- Start the server:
hapi server
- Start a coding session:
hapi
- Open the UI at
http://localhost:3006and log in with the token in~/.hapi/settings.json.
Docker (server only)
docker run -d --name hapi -p 3006:3006 -v hapi-data:/data ghcr.io/tiann/hapi-server:latest
More setup options: Installation guide
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