hapi README

The project's README from github.com/tiann/hapi. As one markdown file: README.md.

HAPI

Run official Claude Code / Codex / Cursor Agent / Grok Build / OpenCode / Kimi / Copilot / Antigravity / Pi / DeepSeek Harness sessions 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

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

Native apps (iOS / Android)

Fully native SwiftUI and Kotlin Compose clients are in development under ios/ and android/. They pair with your hub by scanning the same terminal QR code as the web app, and follow the same protocol — see the client contract docs.

Build from source

Requires Bun 1.4.0.

bun install
bun run build:single-exe

Credits

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

hapi (tiann/hapi)

Searching Database…

5.3K ·GitHub
这是什么?HAPI 让你在自己的电脑上运行官方的 Claude Code、Codex、Cursor Agent、Grok Build、OpenCode、Kimi、Copilot、Antigravity、Pi 或 DeepSeek Harness 编程智能体会话,然后通过网页浏览器、PWA 或 Telegram Mini App 远程操控它们。
这是要替代我的编程智能体,还是只是一个远程控制层?HAPI 是对你现有 AI 智能体的封装,而不是替代它,所以你仍然可以使用原来的终端、操作体验和操作习惯,同时获得远程访问能力。
我该怎么开始使用?在你的电脑上运行 hapi server 命令;它会在终端中打印一个网址和二维码,扫描该二维码(或打开该网址)即可将你的手机或浏览器连接到会话。
原生的 iOS 和 Android 应用现在可以用了吗?还不行——完全原生的 SwiftUI(iOS)和 Kotlin Compose(Android)客户端仍在开发中;目前你可以通过网页/PWA 扫描同一个终端二维码进行连接。
它只支持一种编程智能体吗?不是——它支持 Claude Code、Codex、Cursor Agent、Grok Build、OpenCode、Kimi、Copilot、Antigravity、Pi 和 DeepSeek Harness,因此切换智能体不会改变你的远程工作流程。
我能自己部署,而不依赖默认的中继服务吗?可以——HAPI 提供了自托管方案的文档,可以使用 Cloudflare Tunnel 或 Tailscale 代替内置中继。
远程连接时,我的会话数据是加密的吗?是的——中继连接使用 WireGuard 加 TLS,从你的设备到你的电脑全程端到端加密。
为什么不直接用原版的 Happy 项目?HAPI 被定位为 Happy 的本地优先替代方案,README 中指向一份名为“Why Not Happy?”的专门文档,解释两者之间的主要区别。
我能限制远程会话可以访问哪些文件夹吗?可以——使用一个或多个 --workspace-root 参数启动 runner,即可启用工作区浏览器(Workspace Browser),将远程文件访问范围限制在允许的子目录内。
它是否支持免提语音控制?支持——HAPI 内置语音助手,你无需打字即可与 AI 智能体对话。
HAPI 这个名字是从哪儿来的?HAPI 即“哈皮”,是 Happy 的中文音译,以此致敬启发其诞生的原版 Happy 项目。
Creator
tiann
Size
108.5 MB
Stars
5.3K
Age
9mo
Commits · 90 Days