HAPI：远程控制 Claude Code / Codex 等 AI 编程代理会话的本地优先应用

项目概况

HAPI 可以运行官方 Claude Code / Codex / Cursor Agent / Grok Build / OpenCode / Kimi / Copilot / Antigravity / Pi / DeepSeek Harness 会话，并通过 Web / PWA / Telegram Mini App 远程控制它们。来源说明 HAPI 是 Happy 的本地优先（local-first）替代方案，具体差异见仓库中的 Why Not Happy? 文档。

核心特性

• 无缝交接（Seamless Handoff）：本地工作，需要时切到远程，随时切回；不丢上下文、不重启会话。
• 原生优先（Native First）：HAPI 包装而不是替换你的 AI agent，同样的终端、同样的体验、同样的操作习惯。
• 离开也不中断（AFK Without Stopping）：离开桌前时，可用手机一键批准 AI 请求。
• 多 agent 统一工作流（Your AI, Your Choice）：Claude Code、Codex、Cursor Agent、Grok Build、OpenCode、Kimi、Copilot、Antigravity、Pi、DeepSeek Harness 等不同 agent 共用一套流程。
• 任意位置使用终端（Terminal Anywhere）：从手机或浏览器直接连接到工作机器执行命令。
• 语音控制（Voice Control）：通过内置语音助手免手操作 AI agent。
• 工作区浏览器（Workspace Browser）：需通过一个或多个 hapi runner start --workspace-root <path> 参数按需开启，可在 Web 端浏览限定范围的文件树，并在允许的子目录中启动会话。

远程访问与加密

终端会显示一个 URL 和二维码，用手机扫描二维码或打开 URL 即可访问。中继（relay）使用 WireGuard + TLS 实现端到端加密，数据从你的设备到你的机器全程加密。

自托管与客户端

• 自托管方案（Cloudflare Tunnel、Tailscale）参见仓库 Installation 文档。
• 原生 App（iOS / Android）：完全原生的 SwiftUI 与 Kotlin Compose 客户端正在 ios/ 和 android/ 目录下开发中，通过扫描与 Web 端相同的终端二维码与 hub 配对，并遵循同一协议，详见 client contract 文档。

文档索引

仓库提供 App、How it Works、Supported Agents、Voice Assistant、Why HAPI、FAQ 等文档入口。

适用对象与许可

适用于使用 AI 编程代理、希望离开电脑后仍能跟进会话并批准请求的开发者，以及需要自托管远程访问通道的用户。许可证信息在来源正文中未标注，待核验。

— 本文由 AI 根据公开来源辅助整理，命令、版本与许可证请在使用前到原始页面复核。