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

Files

T

weishu 958e78dc6e refactor: rename HAPI_BOT_URL to HAPI_SERVER_URL

The project is no longer primarily a bot - it now provides HTTP API,
Socket.IO, SSE, and web app backend services. This rename reflects the
broader scope of server functionality.

Updates references in:
- cli/src/configuration.ts (core config)
- cli/src/ui/logger.ts (remote logging)
- cli/src/ui/doctor.ts (diagnostics)
- cli/src/commands/auth.ts (auth status)
- cli/src/daemon/daemon.integration.test.ts (test comments)
- README.md (quickstart docs)
- cli/README.md (CLI docs)
- cli/CLAUDE.md (dev docs)

2025-12-24 19:15:47 +08:00

2.5 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.

Quickstart

Start the server on a machine you control:

npx @twsxtd/hapi server

Alternatively, download the prebuilt binary from Releases and run 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"

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

npx @twsxtd/hapi - Start a Claude Code session.
npx @twsxtd/hapi codex - Start an OpenAI Codex session.
npx @twsxtd/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.5 KiB Raw Blame History