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

T

weishu a665386f05 fix(web): add safe-area-inset-top padding to prevent statusbar overlap on iOS PWA

This fixes an issue where viewport-fit=cover and black-translucent statusbar
configuration allowed content to extend under the iOS statusbar. Added env(safe-area-inset-top)
CSS handling to all main layout components:
- SessionHeader with pt-[env(safe-area-inset-top)]
- SessionsPage, MachinesPage, SpawnPage with safe-area padding
- FilesPage and FilePage headers with safe-area padding

2025-12-21 18:50:40 +08:00

cli

docs: rebrand Happy to HAPI and add component documentation

2025-12-21 18:49:04 +08:00

server

docs: rebrand Happy to HAPI and add component documentation

2025-12-21 18:49:04 +08:00

web

fix(web): add safe-area-inset-top padding to prevent statusbar overlap on iOS PWA

2025-12-21 18:50:40 +08:00

.gitignore

feat(cli): add single executable with embedded web assets support

2025-12-21 08:42:00 +08:00

AGENTS.md

docs: rebrand Happy to HAPI and add component documentation

2025-12-21 18:49:04 +08:00

bun.lock

feat(cli): add Agent Client Protocol (ACP) integration for external agent support

2025-12-21 18:40:04 +08:00

package.json

feat(cli): add single executable with embedded web assets support

2025-12-21 08:42:00 +08:00

README.md

docs: rebrand Happy to HAPI and add component documentation

2025-12-21 18:49:04 +08:00

tsconfig.base.json

init

2025-12-16 15:03:50 +08:00

README.md

hapi

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

Run Claude Code / Codex / Coding Agent sessions locally and control them remotely through a Web / PWA / Telegram mini App.

Quickstart (single executable)

Download the prebuilt hapi binary for your platform and put it on your PATH.
Start the server on a machine you control:

export TELEGRAM_BOT_TOKEN="..."
export ALLOWED_CHAT_IDS="12345678"
export CLI_API_TOKEN="shared-secret"
export WEBAPP_URL="https://your-domain.example"   # required for Telegram Mini App

hapi server

If the server has no public IP, expose it over HTTPS:

Cloudflare Tunnel docs: https://developers.cloudflare.com/cloudflare-one/connections/connect-networks/
Tailscale docs: https://tailscale.com/kb/
Telegram Mini Apps require HTTPS.

Run the CLI on the machine where you want sessions:

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

hapi

The CLI will prompt for CLI_API_TOKEN and save it locally.

Open the UI:

In Telegram, run /app in the bot chat.
In a browser, open WEBAPP_URL and log in with CLI_API_TOKEN.

CLI config file

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

Example:

{
    "cliApiToken": "shared-secret"
}

Requirements

Claude CLI installed and logged in (claude on PATH).
A Telegram bot token from @BotFather (for Mini App access).
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

Build CLI-only binaries:

bun run build:cli:exe
bun run build:cli:exe:all

Docs

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