mirror of https://github.com/wu736139669/hapi.git synced 2026-08-05 06:24:37 +00:00

Files

T

weishu 460c393006 docs: add documentation site with VitePress setup

- 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)

2025-12-31 20:41:02 +08:00

1.7 KiB

Raw Blame History

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:3006 and 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 (claude on PATH) for Claude Code sessions.
Bun if building from source.

Build from source

bun install
bun run build:single-exe

1.7 KiB Raw Blame History