mirror of
https://github.com/wu736139669/hapi.git
synced 2026-08-05 06:24:37 +00:00
460c3930066e652b2442f7a667b60a72b2875f28
- Initialize VitePress documentation site with config, index, and guides - Add guides for quick-start, installation, PWA, how-it-works, FAQ, and why HAPI - Update .gitignore to exclude VitePress cache directory - Update logo.svg with actual icon from web/public/icon.svg - Simplify README.md with link to full installation guide - Remove redundant WHY_NOT_HAPPY.md (content migrated to why-hapi guide)
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
Languages
TypeScript
99.5%
CSS
0.2%
JavaScript
0.2%
HTML
0.1%