* fix(web): use dedicated split breakpoint for compact tablets Some compact Android tablets (e.g. OPPO Pad mini) report a landscape CSS viewport below Tailwind's `lg` (1024px) despite having enough physical screen space, so the sessions layout fell back to a single column. Add a dedicated `split` breakpoint at 920px and use it for the sessions split layout and the sidebar width/resize CSS, leaving the global `lg` breakpoint (and all other pages) untouched. * fix(web): cap sidebar width against viewport on compact split A persisted sidebar width (up to 600px from resizing on desktop) could shrink the detail pane to 316px at the new 920px split breakpoint, below the previous 1024px worst case of 420px. Cap the sidebar width at min(var(--sidebar-w), calc(100vw - 424px)) so the detail pane keeps at least 420px down to 920px, with no effect on desktop. * fix(web): seed sidebar drag from rendered width When the compact-split viewport cap renders the sidebar narrower than the persisted width, dragging the handle to shrink it had a dead zone until the stored width fell below the rendered width. Seed the drag from the sidebar's rendered width so it responds immediately; unchanged on desktop where rendered and stored widths match.
HAPI
Run official Claude Code / Codex / Cursor Agent / Grok Build / 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, Grok Build, OpenCode—different agents, 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.
- Workspace Browser - Opt-in via one or more
hapi runner start --workspace-root <path>flags: browse scoped file trees from the web and start sessions in allowed subdirectories.
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.