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

T

Junmo KimandGitHub b712ee67a5 fix(web): fall back to getRandomValues when crypto.randomUUID is unavailable (#523 )

crypto.randomUUID is only exposed in secure contexts (HTTPS or
localhost). When the web app is served over HTTP on a LAN IP the
attachment adapter, toast provider, message localId helper, file
attachment metadata and terminal id creation all call
crypto.randomUUID() synchronously and throw TypeError, so the UI
silently does nothing (e.g. the file picker opens and closes with no
chip).

Add a small web/src/lib/randomId helper that tries crypto.randomUUID
first, then falls back to crypto.getRandomValues-derived UUID v4,
and finally to a Date.now/Math.random string for very old
environments. Route all five call sites through it. Output format is
identical for secure contexts and UUID v4 for the getRandomValues
path, so existing DB/SSE/RPC consumers see the same shape.

2026-04-24 13:59:19 +08:00

.github

Add support for PR live review

2026-03-08 11:13:56 +08:00

cli

remove transcript timeout for codex

2026-04-24 13:45:16 +08:00

docs

feat(cli): support optional extra headers for hub requests (#445 )

2026-04-14 13:54:51 +08:00

hub

fix(hub): deliver message-received events to all:true SSE connections (#507 )

2026-04-22 10:41:56 +08:00

shared

Preserve history when deduplicating agent sessions (#471 )

2026-04-21 13:56:50 +08:00

web

fix(web): fall back to getRandomValues when crypto.randomUUID is unavailable (#523 )

2026-04-24 13:59:19 +08:00

website

feat: rename server package to hub

2026-01-27 19:51:21 +08:00

.gitignore

fix(sync): add SSE heartbeat and alive status (#223 )

2026-02-28 01:46:21 +08:00

AGENTS.md

Prioritize Pragmatism, and Avoid Overengineering.

2026-03-16 22:27:25 +08:00

bun.lock

Release version 0.17.0

2026-04-24 12:07:52 +08:00

CONTRIBUTING.md

perfer GPT-5.4

2026-03-06 20:26:18 +08:00

LICENSE

chore: migrate to AGPL-3.0-only

2026-01-04 20:45:15 +08:00

package.json

Add About section to settings page with version info and tests (#119 )

2026-01-30 09:48:49 +08:00

README.md

rm tg

2026-03-20 12:15:24 +08:00

refactor.md

remove transcript timeout for codex

2026-04-24 13:45:16 +08:00

SECURITY.md

Update SECURITY.md

2026-03-29 09:47:17 +08:00

tsconfig.base.json

init

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

README.md

HAPI

Run official Claude Code / Codex / Gemini / OpenCode 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

Seamless Handoff - Work locally, switch to remote when needed, switch back anytime. No context loss, no session restart.
Native First - HAPI wraps your AI agent instead of replacing it. Same terminal, same experience, same muscle memory.
AFK Without Stopping - Step away from your desk? Approve AI requests from your phone with one tap.
Your AI, Your Choice - Claude Code, Codex, Cursor Agent, Gemini, OpenCode—different models, one unified workflow.
Terminal Anywhere - Run commands from your phone or browser, directly connected to the working machine.
Voice Control - Talk to your AI agent hands-free using the built-in voice assistant.

Demo

https://github.com/user-attachments/assets/38230353-94c6-4dbe-9c29-b2a2cc457546

Getting Started

npx @twsxtd/hapi hub --relay     # start hub with E2E encrypted relay
npx @twsxtd/hapi                 # run claude code

hapi server remains supported as an alias.

The terminal will display a URL and QR code. Scan the QR code with your phone or open the URL to access.

The relay uses WireGuard + TLS for end-to-end encryption. Your data is encrypted from your device to your machine.

For self-hosted options (Cloudflare Tunnel, Tailscale), see Installation

Docs

Build from source

bun install
bun run build:single-exe

Credits

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