HAPI is a TypeScript local-first app that lets you run Claude Code, Codex, Pi and other agents locally and control them remotely via Web, PWA, or Telegram Mini App. It supports workspace browsing and voice control, with multiple release updates and ongoing maintenance.
Collecting history — the radar snapshots this repo daily. The trend line appears after 3 days of data (1 so far).
What it is
HAPI is an app that runs official Claude Code, Codex, Cursor Agent, Grok Build, OpenCode, Kimi, Copilot, Antigravity, Pi sessions locally and enables remote control through Web / PWA / Telegram Mini App.
How it works
The project provides a local-first workflow where you run an agent locally and can switch to remote as needed. It includes a workspace browser feature (opt-in via workspace-root flags) to browse file trees from the web and start sessions in allowed subdirectories. The relay uses WireGuard + TLS for end-to-end encryption between device and machine. The CLI/terminal interface is preserved to match the user experience.
Getting started
Getting started commands from the README:
npx @twsxtd/hapi hub --relay # start hub with E2E encrypted relay
npx @twsxtd/hapi # run claude code
The server alias hapi server remains supported. The terminal will display a URL and QR code for access. For self-hosted options, see Installation in docs.
Recent releases
- v0.26.0 Release v0.26.0 (2026-08-04): * feat: use official Pi agent logo by @swear01 in https://github.com/tiann/hapi/pull/1335; * feat(web): show hidden directories in workspace browser by @weixiang1862 in https://github
- v0.25.4 Release v0.25.4 (2026-08-03): * fix(web): make inactive session notices flush with headers by @techotaku39 in https://github.com/tiann/hapi/pull/1299; * feat(web): customize composer toolbar visibility by @techota
- v0.25.3 Release v0.25.3 (2026-08-02): * fix(web): align outline close button styling by @techotaku39 in https://github.com/tiann/hapi/pull/1150; * fix(cli): restore Pi session resume by @nannant666 in https://github.com/t
- v0.25.2 Release v0.25.2 (2026-08-02): * fix(web): align outline close button styling by @techotaku39 in https://github.com/tiann/hapi/pull/1150; * fix(cli): restore Pi session resume by @nannant666 in https://github.com/t
- v0.25.1 Release v0.25.1 (2026-07-28): Full Changelog: https://github.com/tiann/hapi/compare/v0.25.0...v0.25.1
## Traction
stars: 4709
forks: 513
open_issues: 147
## Behind the repo
(Linked startup/company not provided in the facts.)
## Caveats
license: AGPL-3.0
language: TypeScript
created: 2025-12-24
last_push: 2026-08-04