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

T

Haoqing WangandGitHub 9a48d5af3a fix(hub,web): extend JWT expiration and harden visibility refresh (#442 )

- Extend JWT expiration from 15 minutes to 4 hours in both auth and
  bind endpoints. 15 minutes was too short — browser timer throttling
  in background tabs prevented the scheduled refresh from firing
  before expiration, causing unexpected logouts.

- Change the visibility/focus refresh from conditional (minTtlMs) to
  forced, so returning to a backgrounded tab always re-authenticates
  regardless of remaining token TTL. This eliminates the race between
  timer throttling and token expiration.

HAPI is a self-hosted tool, so the longer token lifetime is an
acceptable security tradeoff. The auth source (Telegram initData or
CLI access token) is still validated on every refresh.

Closes #412

2026-04-11 22:03:50 +08:00

.github

Add support for PR live review

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

cli

fix(security): potential command injection on windows due to `she (#439 )

2026-04-11 21:37:27 +08:00

docs

fix(terminal): prevent infinite reconnect loop on Windows hosts (#336 )

2026-03-21 21:45:40 +08:00

hub

fix(hub,web): extend JWT expiration and harden visibility refresh (#442 )

2026-04-11 22:03:50 +08:00

shared

Fix Codex reasoning effort resume and updates

2026-04-10 11:50:03 +08:00

web

fix(hub,web): extend JWT expiration and harden visibility refresh (#442 )

2026-04-11 22:03:50 +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

feat(web): redesign sidebar with resizable width and 3-level hierarchy (#427 )

2026-04-11 09:52:56 +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

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.