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

Files

T

weishu 90cb7dae05 feat: add Homebrew installation support for hapi CLI

- Update CI workflow to package release artifacts with correct naming (hapi-* prefix)
- Generate SHA256 checksums for all artifacts
- Auto-update homebrew-tap repository on release
- Add Installation section to README with Homebrew, npm, and binary options
- Simplify .release-it.json config as CI now handles release process
- Add update-homebrew-formula script to update formula in homebrew-tap
- Add release-artifacts directory to .gitignore

Users can now install via: brew install tiann/tap/hapi

2025-12-25 10:23:16 +08:00

2.7 KiB

Raw Blame History

hapi

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

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

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

Homebrew (macOS/Linux)

brew install tiann/tap/hapi

npm/npx

npx @twsxtd/hapi

Or install globally:

npm install -g @twsxtd/hapi

Prebuilt binary

Download from Releases.

Quickstart

Start the server on a machine you control:

hapi server
# or: npx @twsxtd/hapi server

If the server has no public IP, expose it over HTTPS:
- Cloudflare Tunnel: https://developers.cloudflare.com/cloudflare-one/connections/connect-networks/
- Tailscale: https://tailscale.com/kb/
Run the CLI on the machine where you want sessions:

# If the server is not on localhost:3006
export HAPI_SERVER_URL="https://your-domain.example"

hapi
# or: npx @twsxtd/hapi

Open the UI in a browser at the server URL and log in with CLI_API_TOKEN.

Telegram Mini App (optional)

To use Telegram for notifications and the Mini App:

Create a bot with @BotFather and get the token.
Expose your server over HTTPS (Cloudflare Tunnel, Tailscale, etc.).
Add environment variables:

WEBAPP_URL="https://your-domain.example"
TELEGRAM_BOT_TOKEN="..."

Start the server and send /start to the bot to get your chat ID.
Add your chat ID and restart:

ALLOWED_CHAT_IDS="12345678"

Run /app in the bot chat to open the Mini App.

Multi-agent support

hapi - Start a Claude Code session.
hapi codex - Start an OpenAI Codex session.
hapi gemini - Start a Google Gemini session.

CLI config file

You can store the token in ~/.hapi/settings.json instead of an env var. Environment variables take priority over the file.

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

Build a single binary with embedded web assets:

bun run build:single-exe

Docs

cli/README.md - CLI usage and config
server/README.md - Server setup and architecture
web/README.md - Web app behavior and dev workflow

License

cli: MIT
others: LGPLv2

2.7 KiB Raw Blame History